Function isHeadlessShellBinary

packages/cli/src/browser/manager.ts:226–229

* True iff the binary at `executablePath` is `chrome-headless-shell` (i.e. the * Chromium build that still exposes `HeadlessExperimental.enable` / * `beginFrame`). Regular Chrome and `chromium` have dropped those domains, so * the engine's perf-optimized BeginFrame capture path silently degrades

(executablePath: string)

 * screenshot mode when those are used.
 */
function isHeadlessShellBinary(executablePath: string): boolean {
  const name = basename(executablePath).toLowerCase();
  return name === "chrome-headless-shell" || name === "chrome-headless-shell.exe";
}

/**
 * Emit a one-time warning when the CLI selects a non-headless-shell binary on