System dependencies
Install the WebKitGTK runtime and development headers for your distribution before installing or building WebviewJS:Supported architectures
The
i686 (x86 32-bit) target compiles but has no automated CI coverage.
Test thoroughly before shipping production builds on 32-bit Linux.Tested environments
Wayland support
WebviewJS uses Tao’s native Wayland backend automatically when a Wayland compositor is present. You can retrieve the native Wayland surface pointer for interoperability with other native libraries:- Window decorations on Wayland are drawn client-side rather than by the compositor.
- Absolute window positioning via
win.setPosition()may be ignored on compositors that enforce the XDG Shell placement protocol (e.g. GNOME Wayland). - Screen-capture and content-protection APIs are compositor-dependent.
Known limitations
System tray — pointer events
System tray — pointer events
Pointer events (
click, mouse-enter, mouse-move, mouse-leave) are
not emitted from TrayIcon on Linux. Register click listeners for
visual feedback on Windows and macOS only.setSkipTaskbar
setSkipTaskbar
win.setSkipTaskbar(true) is supported on Linux, but the final behaviour
depends on the desktop environment and window manager. It may not work as
expected on all Linux desktop environments.Automation
WebContext exposes an allowsAutomation flag that enables WebDriver-based automated testing:
FreeBSD
A
x86_64-unknown-freebsd target exists in the build matrix, but it has
no CI coverage and the GUI layer is a stub with no real windowing
implementation. FreeBSD is not suitable for production use of WebviewJS at
this time.