macOS hosts and targets
macOS, 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”). Pin the
default regime with --setpref ui.systemUsesDarkTheme=0, --setpref ui.useAccessibilityTheme=0 and --setpref ui.useOverlayScrollbars=0 (or =1
when the reading needs overlay scrollbars), and read each one back.
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 about 11px; a headless run reads this desktop’s own (HEADLESS).
SCROLLBARS
Scrollbars follow the system’s scroller style (HEADLESS).
CONTRAST
The forced-colors prefs give chrome prefers-contrast, not forced colors: see
desktop-theme-colors §2 “Simulate the other realm’s regime” for the override
that puts chrome under forced colors.
COMPOSITING
Not applicable: no rule here depends on vibrancy or other macOS-only compositing.
PATHS
The binary is <objdir>/dist/<App>.app/Contents/MacOS/firefox; dist/bin is a
staging copy that fails at startup. The system temp directory is $TMPDIR,
where firefox-probe.py keeps a failed run’s browser log
(desktop-theme-probing §6 “Leave the tree clean”). A plain jar.mn entry is a
symlink into the source tree, as on Linux
(§2 “What is live at the next launch” in
build-freshness.md).
GRABS
An uncropped grab covers the main display alone, in device pixels (2x on
Retina); a crop is in points, and Pillow returns it at 1x, so a Retina crop is
downsampled. Without the Screen Recording permission for the terminal the grab
holds only the wallpaper and still exits 0; check the PNG shows the window
before reading it. Before reading a grab, read §2 “The compositor’s output” in
measuring-pixels.md.