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.