A VNC connection can choose how the server encodes its screen for rustguac: Auto (default, unchanged), LAN (Ultra/ZRLE/Hextile first, low compression, top JPEG quality), WAN (Tight/ZRLE, compression and JPEG quality 6) or Slow link (Tight, compression 9, JPEG quality 3, 16-bit colour unless the connection sets a colour depth). They set guacd's encodings, compress-level and quality-level; Auto sends none of them. An unknown preset is refused rather than ignored. Web sessions are unchanged. Docs: the VNC section of the overview now covers screen size, the presets, and which VNC authentication methods work (VNC password, VeNCrypt, macOS, UltraVNC MS-Logon II) and which don't (RSA-AES, UltraVNC encryption plugins, MS-Logon III).
End-to-end tests
Playwright specs that drive the real pages in static/ against a stubbed
API. Nothing here needs Vault, guacd, Docker or a browser session: serve.mjs
serves the static tree over HTTP and every spec installs lib/api.mjs, which
answers /api/* from a small fixture address book (two named tenants and
twenty generic ones, two sessions, two recordings) and records every request
the page makes so a spec can assert on what was sent.
cd tests/e2e
npm ci
npx playwright install chromium # once
npm test # all specs
npx playwright test specs/global-search.spec.mjs
npx playwright test --ui # step through a spec
PW_CHROMIUM=/path/to/chrome runs against an already installed Chromium
instead of the one Playwright downloads. CI runs the suite in the e2e job.
One spec per change, named after the branch that introduced it:
| spec | pins |
|---|---|
tables-1710 |
#252: no horizontal overflow at 1710px on Connections, Recordings and Reports, with short and with long unbreakable names |
connections-sidebar |
#254: independent sidebar scroll, selected row marked and kept in view |
connections-folder-filter |
#254: live filter box, ARIA tree, arrow keys, f shortcut |
connections-app-shell |
#254: clipped body, two scroll panes, folder change scrolls the pane not the page |
role-nav |
one nav on every page, gated by data-role-level |
sessions-adhoc-modal |
#295: Sessions has no ad-hoc form or button of its own; the global button there opens the editor on Connections |
adhoc-button |
#295: search.js's Connect to a host beside the box on every search page, for poweruser and admin, in place on Connections and via #adhoc elsewhere; never for operator, viewer, signed out or on the login page; gone on expiry and logout; shown without Vault; API key confirmed first |
facet-filters |
shared facets narrow lists, persist, combine with search |
folder-display-name |
display name over the key, modal field round-trips |
themed-dialogs |
rgConfirm/rgAlert replace native dialogs |
global-search |
/ opens the overlay on every signed-in page, folder view untouched; nothing on the login page, for anonymous or viewer callers, or from a previous login's cache |
search-under-modals |
a page modal (the ad-hoc editor included) covers the search box |
zero-click-fullscreen |
#257: same-tab iframe sized from the measured viewport |
connections-adhoc |
#295: Connect to a host opens the entry editor in ad-hoc mode (no name, Connect for Save, entry-only options hidden for non-admins), offers the caller's credential variable names, posts to /api/addressbook/adhoc/connect and never /api/sessions; ephemeral keypair; missing variable named; admin Save as entry keeps $var references; works without Vault and from #adhoc; no button for operators |
recordings-mp4 |
#241: the mp4 button converts, shows progress and downloads; refused while live; hidden without server support |
The fixture suppresses the first-visit onboarding tour (options.onboarding
re-enables it) and defaults to the admin role; pass role to test gating.