mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 19:36:04 +00:00
* ci(windows): probe that a render opens no visible window * ci(windows): the probe names what opened each window * ci(windows): the probe spawns each binary alone, with and without detached * ci(windows): the probe logs the processes started during the render * ci(windows): the probe also spawns Chrome one consoleless hop down * ci(windows): the probe logs each child started without windowsHide * ci(windows): the probe logs every child process with its windowsHide and detached * fix(engine): Chrome keeps the CLI's console on Windows, so a render opens no window * fix(cli): every child the CLI starts on Windows is hidden unless it opts out * ci(windows): the probe bisects Chrome's flags and keeps each command's output * ci(windows): the probe names the Chrome process behind each window * ci(windows): the probe loads a page in Chrome directly and one hidden hop down * ci(windows): the probe prints the Chrome main command line and renders with the reporter's flags * ci(windows): the probe narrows the CLI's Chrome arguments to the ones that open a window * ci(windows): the probe launches the CLI's Chrome arguments one hidden hop down * ci(windows): the probe launches Chrome through the engine's browser pool * ci(windows): the probe varies what the engine passes to Puppeteer * fix(engine): renders on Windows launch Chrome with a Puppeteer that keeps it attached * refactor(cli): hideChildConsoles copies its arguments and keeps one comment line
112 lines
4.4 KiB
TypeScript
112 lines
4.4 KiB
TypeScript
import { spawnSync } from "node:child_process";
|
|
import { debuglog } from "node:util";
|
|
import { release } from "node:os";
|
|
|
|
/** Chrome 151 dropped macOS 12 and older (Darwin < 22); 150 is the last major that launches there. */
|
|
const MACOS_12_LAST_CHROME_MAJOR = 150;
|
|
|
|
/** Newest Chrome major this host can run, or undefined when it has no ceiling. */
|
|
export function chromeMajorCeiling(
|
|
hostPlatform: string = process.platform,
|
|
hostRelease: string = release(),
|
|
): number | undefined {
|
|
if (hostPlatform !== "darwin") return undefined;
|
|
return Number.parseInt(hostRelease, 10) < 22 ? MACOS_12_LAST_CHROME_MAJOR : undefined;
|
|
}
|
|
|
|
/** True when a cache dir name (`mac-152.0.1.2`) or build id (`152.0.1.2`) is newer than the ceiling. */
|
|
export function exceedsChromeCeiling(versionName: string, ceiling: number | undefined): boolean {
|
|
if (ceiling === undefined) return false;
|
|
const major = Number.parseInt(versionName.slice(versionName.indexOf("-") + 1), 10);
|
|
return major > ceiling;
|
|
}
|
|
|
|
// Deliberately Beta, not Canary: 153.0.8000.0 measured identical to this build on every probe. macOS 12 gets 150,
|
|
// the last headless shell that launches there; it exposes canvas.drawElementImage under CanvasDrawElement.
|
|
const CHROME_VERSION = "152.0.7977.30";
|
|
const MACOS_12_CHROME_VERSION = "150.0.7871.124";
|
|
|
|
export function managedChromeVersion(
|
|
hostPlatform: string = process.platform,
|
|
hostRelease: string = release(),
|
|
): string {
|
|
return chromeMajorCeiling(hostPlatform, hostRelease) === undefined
|
|
? CHROME_VERSION
|
|
: MACOS_12_CHROME_VERSION;
|
|
}
|
|
|
|
export const isManagedChromeDir = (versionName: string): boolean =>
|
|
versionName.slice(versionName.indexOf("-") + 1) === managedChromeVersion();
|
|
|
|
/** Newest first, by numeric build (`linux-148.0.1` before `linux-99.0.1`). */
|
|
export function compareBrowserVersionsDescending(left: string, right: string): number {
|
|
const parse = (value: string): number[] => {
|
|
const version = value.slice(value.indexOf("-") + 1);
|
|
const segments: number[] = [];
|
|
for (const segment of version.split(".")) {
|
|
const parsed = Number.parseInt(segment, 10);
|
|
if (!Number.isFinite(parsed)) break;
|
|
segments.push(parsed);
|
|
}
|
|
return segments;
|
|
};
|
|
const leftSegments = parse(left);
|
|
const rightSegments = parse(right);
|
|
const length = Math.max(leftSegments.length, rightSegments.length);
|
|
for (let index = 0; index < length; index += 1) {
|
|
const difference = (rightSegments[index] ?? 0) - (leftSegments[index] ?? 0);
|
|
if (difference !== 0) return difference;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
const starts = new Map<string, boolean>();
|
|
const debug = debuglog("hyperframes:browser");
|
|
|
|
/** Whether a shell loads a blank page and exits: an old build can die at launch on a newer OS. Asked once per path. */
|
|
export function shellStarts(binary: string, timeoutMs = 10_000): boolean {
|
|
let answer = starts.get(binary);
|
|
if (answer === undefined) {
|
|
const probe = ["--no-sandbox", "--dump-dom", "about:blank"];
|
|
answer =
|
|
spawnSync(binary, probe, {
|
|
stdio: "ignore",
|
|
timeout: timeoutMs,
|
|
killSignal: "SIGKILL",
|
|
windowsHide: true,
|
|
})?.status === 0;
|
|
if (!answer) debug("skipping %s: it did not start", binary);
|
|
starts.set(binary, answer);
|
|
}
|
|
return answer;
|
|
}
|
|
|
|
/** The shared Puppeteer cache's shell: the managed build, else the newest under the host's ceiling that starts.
|
|
* `shell` names a version dir's executable, or undefined when it holds no usable file. */
|
|
export function pickSharedShell(
|
|
versions: readonly string[],
|
|
shell: (version: string) => string | undefined,
|
|
): string | undefined {
|
|
const managed = versions.find(isManagedChromeDir);
|
|
const pinned = managed && shell(managed);
|
|
if (pinned) return pinned;
|
|
const ceiling = chromeMajorCeiling();
|
|
for (const version of [...versions].sort(compareBrowserVersionsDescending)) {
|
|
if (version === managed || exceedsChromeCeiling(version, ceiling)) continue;
|
|
const binary = shell(version);
|
|
if (binary && shellStarts(binary)) return binary;
|
|
}
|
|
return undefined;
|
|
}
|
|
|
|
/** The browser binary an env var names. The CLI and the engine both resolve it here, HYPERFRAMES_BROWSER_PATH first. */
|
|
export function browserPathFromEnv(
|
|
env: NodeJS.ProcessEnv = process.env,
|
|
): { name: "HYPERFRAMES_BROWSER_PATH" | "PRODUCER_HEADLESS_SHELL_PATH"; path: string } | undefined {
|
|
for (const name of ["HYPERFRAMES_BROWSER_PATH", "PRODUCER_HEADLESS_SHELL_PATH"] as const) {
|
|
const path = env[name];
|
|
if (path) return { name, path };
|
|
}
|
|
return undefined;
|
|
}
|