Skip to content

Frequently asked questions

Can I use JavaScript? No. There is no JavaScript engine. All logic runs in your Python or PowerShell program, which receives events and updates the page. See why native.

Can a page load images or CSS from the internet? No. Network URLs are always denied. Use local files under the asset root, registered ui4me-res:// bundles or inline styles. Your program itself may use the network and then display the result.

Why does my script run twice? The first run is the launcher that starts the native host; the host runs your script again as its backend. Keep side effects below Application.start() / Start-NativeHTMLKitScript or inside main(). See lifecycle.

Why does a click handler wait while a file dialog is open (Python)? Events are delivered in order on one worker thread, and open_files() waits for the user by default. Use wait=False and a done-callback. See file dialogs (PowerShell).

Why do clipboard or file-dialog calls fail in CI? In headless test mode (NATIVEHTMLKIT_TEST_MODE=1) there is no native event loop: clipboard and native dialogs fail with RPC error -32001. Catch the error and show a message, as the examples do.

Can I simulate clicks in headless tests? There is no synthetic input. You can drive documented document operations — for example request_submit fires the form's submit event and replace_control_range fires input — and read the DOM back with get_text, get_value or get_html. Real input needs an interactive desktop.

uv add nativehtmlkit fails or installs a package without the host on Linux. The released Linux wheel is manylinux_2_39_x86_64: it needs glibc 2.39 or newer. On older systems the installer can only fall back to the source package, which has no native host. Run uv run nativehtmlkit-python doctor to check.

Does it work with Windows PowerShell 5.1? Yes, on Windows. Linux needs PowerShell 7.2 or newer.

Does it support macOS? Not in the current releases. Targets are Linux (KDE Plasma, Wayland) and Windows x64.

Is there a UI component library or a command-line tool? They are under development and not public for now; development is focused on Core. See Project status.

Are the screenshots on this site real? Images marked as illustrations or placeholders are not captures. Real screenshots are added only after interactive verification on a native desktop.

How do I report a bug? Open an issue in the repository that owns the behaviour: rendering and native windows in Core, language APIs in Python or PowerShell, and documentation in this site's repository. Include the versions and, if possible, a diagnostic report (see troubleshooting (PowerShell)).