Windows hosts and targets

Windows, as a probe’s host and as a bug’s target.

HEADLESS

A headless run reads the host’s own look and feel (widget/docs/look-and-feel.md, “Headless”), the accent color in the title bar included. Pin the default regime with --setpref ui.systemUsesDarkTheme=0, --setpref ui.useAccessibilityTheme=0, --setpref ui.useOverlayScrollbars=0 (or =1 when the reading needs overlay scrollbars) and --setpref ui.windowsAccentColorInTitlebar=0, and read each one back. A headless run also reproduces chrome’s requested forced-colors regime exactly.

DISPLAYS

No isolated display: a non-headless run opens on the logged-in desktop whatever you pass it, so the rungs go from headless straight to the user’s session or a try run, which is the only isolated real display. firefox-probe.py --no-headless prints a warning that the run contends with whatever else is on screen.

FONT

Chrome’s root is 12px: the Segoe UI 9pt message font at any scale factor, with the text-size setting applied as a zoom on top. A headless run reads this desktop’s own (HEADLESS).

SCROLLBARS

Windows 11 shows overlay scrollbars unless the user turns on “Always show scrollbars” (widget.windows.overlay-scrollbars.enabled lets Firefox follow that setting); Windows 10 shows classic ones (HEADLESS).

CONTRAST

Chrome is requested, not active (css_guidelines “High contrast mode”); to simulate it, desktop-theme-colors §2 “Simulate the other realm’s regime”.

In the light scheme that high contrast forces, Highlight, SelectedItem and -moz-menuhover resolve to one color, and HighlightText, SelectedItemText and usually -moz-menuhovertext to another (the source is in desktop-theme-colors’ references/system-color-pairs.md §1).

COMPOSITING

Mica and acrylic cannot be painted on another host. Sample the reporter’s backdrop as desktop-theme-screenshots §6 “Read a reporter’s screenshot by sampling it” says. To test a Windows-only rule’s cascade (ui.windowsMica=1) elsewhere, read §4 “Test another platform’s rule” in probe-recipes.md.

PATHS

The binary is <objdir>/dist/bin/firefox.exe, and the system temp directory is %TEMP%. A jar.mn entry is a copy where the build cannot create a symlink (build/docs/jar-manifests.md, “In a Local Build”); on Windows it is a copy unless Developer Mode or an elevated shell allows symlinks. find <objdir>/dist/bin -type l printing nothing means copies, so run ./mach build faster after each edit (§2 “What is live at the next launch” in build-freshness.md).

GRABS

An uncropped grab spans every screen with (0, 0) at the virtual desktop’s top-left corner, so when a monitor sits left of or above the primary one, the recorded origin is off by that monitor’s extent. Before reading a grab, read §2 “The compositor’s output” in measuring-pixels.md.