import { access, createWriteStream, existsSync, mkdirSync, symlink, } from "node:fs"; import { https } from "follow-redirects"; import LambdaFS from "./lambdafs"; import { join } from "node:path"; import { URL } from "node:url"; import { downloadAndExtract, isRunningInAwsLambda, isValidUrl } from "./helper"; /** Viewport taken from https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.viewport.md */ interface Viewport { /** * The page width in pixels. */ width: number; /** * The page height in pixels. */ height: number; /** * Specify device scale factor. * See {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/devicePixelRatio | devicePixelRatio} for more info. * @defaultValue 1 */ deviceScaleFactor?: number; /** * Whether the `meta viewport` tag is taken into account. * @defaultValue false */ isMobile?: boolean; /** * Specifies if the viewport is in landscape mode. * @defaultValue false */ isLandscape?: boolean; /** * Specify if the viewport supports touch events. * @defaultValue false */ hasTouch?: boolean; } if (isRunningInAwsLambda()) { if (process.env.FONTCONFIG_PATH === undefined) { process.env.FONTCONFIG_PATH = "/tmp/aws"; } if (process.env.LD_LIBRARY_PATH === undefined) { process.env.LD_LIBRARY_PATH = "/tmp/aws/lib"; } else if (process.env.LD_LIBRARY_PATH.startsWith("/tmp/aws/lib") !== true) { process.env.LD_LIBRARY_PATH = [ ...new Set(["/tmp/aws/lib", ...process.env.LD_LIBRARY_PATH.split(":")]), ].join(":"); } } class Chromium { /** * Determines the headless mode that chromium will run at * https://developer.chrome.com/articles/new-headless/#try-out-the-new-headless * @values true or "new" */ private static headlessMode: true | "new" = "new"; /** * If true, the graphics stack and webgl is enabled, * If false, webgl will be disabled. (If false, the swiftshader driver will also not extract) */ static graphicsStackMode: boolean = true; /** * Downloads or symlinks a custom font and returns its basename, patching the environment so that Chromium can find it. */ static font(input: string): Promise { if (process.env.HOME === undefined) { process.env.HOME = "/tmp"; } if (existsSync(`${process.env.HOME}/.fonts`) !== true) { mkdirSync(`${process.env.HOME}/.fonts`); } return new Promise((resolve, reject) => { if (/^https?:[/][/]/i.test(input) !== true) { input = `file://${input}`; } const url = new URL(input); const output = `${process.env.HOME}/.fonts/${url.pathname .split("/") .pop()}`; if (existsSync(output) === true) { return resolve(output.split("/").pop() as string); } if (url.protocol === "file:") { access(url.pathname, (error) => { if (error != null) { return reject(error); } symlink(url.pathname, output, (error) => { return error != null ? reject(error) : resolve(url.pathname.split("/").pop() as string); }); }); } else { https.get(input, (response) => { if (response.statusCode !== 200) { return reject(`Unexpected status code: ${response.statusCode}.`); } const stream = createWriteStream(output); stream.once("error", (error) => { return reject(error); }); response.on("data", (chunk) => { stream.write(chunk); }); response.once("end", () => { stream.end(() => { return resolve(url.pathname.split("/").pop() as string); }); }); }); } }); } /** * Returns a list of additional Chromium flags recommended for serverless environments. * The canonical list of flags can be found on https://peter.sh/experiments/chromium-command-line-switches/. */ static get args(): string[] { /** * These are the default ares in puppeteer. * https://github.com/puppeteer/puppeteer/blob/3a31070d054fa3cd8116ca31c578807ed8d6f987/packages/puppeteer-core/src/node/ChromeLauncher.ts#L185 */ const puppeteerFlags = [ "--allow-pre-commit-input", "--disable-background-networking", "--disable-background-timer-throttling", "--disable-backgrounding-occluded-windows", "--disable-breakpad", "--disable-client-side-phishing-detection", "--disable-component-extensions-with-background-pages", "--disable-component-update", "--disable-default-apps", "--disable-dev-shm-usage", "--disable-extensions", "--disable-hang-monitor", "--disable-ipc-flooding-protection", "--disable-popup-blocking", "--disable-prompt-on-repost", "--disable-renderer-backgrounding", "--disable-sync", "--enable-automation", // TODO(sadym): remove '--enable-blink-features=IdleDetection' once // IdleDetection is turned on by default. "--enable-blink-features=IdleDetection", "--export-tagged-pdf", "--force-color-profile=srgb", "--metrics-recording-only", "--no-first-run", "--password-store=basic", "--use-mock-keychain", ]; const puppeteerDisableFeatures = [ "Translate", "BackForwardCache", // AcceptCHFrame disabled because of crbug.com/1348106. "AcceptCHFrame", "MediaRouter", "OptimizationHints", ]; const puppeteerEnableFeatures = ["NetworkServiceInProcess2"]; const chromiumFlags = [ "--disable-domain-reliability", // https://github.com/GoogleChrome/chrome-launcher/blob/main/docs/chrome-flags-for-tools.md#background-networking "--disable-print-preview", // https://source.chromium.org/search?q=lang:cpp+symbol:kDisablePrintPreview&ss=chromium "--disable-speech-api", // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableSpeechAPI&ss=chromium "--disk-cache-size=33554432", // https://source.chromium.org/search?q=lang:cpp+symbol:kDiskCacheSize&ss=chromium "--mute-audio", // https://source.chromium.org/search?q=lang:cpp+symbol:kMuteAudio&ss=chromium "--no-default-browser-check", // https://source.chromium.org/search?q=lang:cpp+symbol:kNoDefaultBrowserCheck&ss=chromium "--no-pings", // https://source.chromium.org/search?q=lang:cpp+symbol:kNoPings&ss=chromium ]; const chromiumDisableFeatures = [ "AudioServiceOutOfProcess", "IsolateOrigins", "site-per-process", ]; const chromiumEnableFeatures = ["SharedArrayBuffer"]; const graphicsFlags = [ "--hide-scrollbars", // https://source.chromium.org/search?q=lang:cpp+symbol:kHideScrollbars&ss=chromium "--ignore-gpu-blocklist", // https://source.chromium.org/search?q=lang:cpp+symbol:kIgnoreGpuBlocklist&ss=chromium "--in-process-gpu", // https://source.chromium.org/search?q=lang:cpp+symbol:kInProcessGPU&ss=chromium "--window-size=1920,1080", // https://source.chromium.org/search?q=lang:cpp+symbol:kWindowSize&ss=chromium ]; // https://chromium.googlesource.com/chromium/src/+/main/docs/gpu/swiftshader.md this.graphicsStackMode ? graphicsFlags.push("--use-gl=angle", "--use-angle=swiftshader") : graphicsFlags.push("--disable-webgl"); const insecureFlags = [ "--allow-running-insecure-content", // https://source.chromium.org/search?q=lang:cpp+symbol:kAllowRunningInsecureContent&ss=chromium "--disable-setuid-sandbox", // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableSetuidSandbox&ss=chromium "--disable-site-isolation-trials", // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableSiteIsolation&ss=chromium "--disable-web-security", // https://source.chromium.org/search?q=lang:cpp+symbol:kDisableWebSecurity&ss=chromium "--no-sandbox", // https://source.chromium.org/search?q=lang:cpp+symbol:kNoSandbox&ss=chromium "--no-zygote", // https://source.chromium.org/search?q=lang:cpp+symbol:kNoZygote&ss=chromium ]; const headlessFlags = [ this.headless === "new" ? "--headless='new'" : "--headless", ]; return [ ...puppeteerFlags, ...chromiumFlags, `--disable-features=${[ ...puppeteerDisableFeatures, ...chromiumDisableFeatures, ].join(",")}`, `--enable-features=${[ ...puppeteerEnableFeatures, ...chromiumEnableFeatures, ].join(",")}`, ...graphicsFlags, ...insecureFlags, ...headlessFlags, ]; } /** * Returns sensible default viewport settings. */ static get defaultViewport(): Required { return { deviceScaleFactor: 1, hasTouch: false, height: 1080, isLandscape: true, isMobile: false, width: 1920, }; } /** * Inflates the included version of Chromium * @param input The location of the `bin` folder * @returns The path to the `chromium` binary */ static async executablePath(input?: string): Promise { /** * If the `chromium` binary already exists in /tmp/chromium, return it. */ if (existsSync("/tmp/chromium") === true) { return Promise.resolve("/tmp/chromium"); } if (input && isValidUrl(input)) { return this.executablePath(await downloadAndExtract(input)); } /** * If input is defined, use that as the location of the brotli files, * otherwise, the default location is ../bin. * A custom location is needed for workflows that using custom packaging. */ input ??= join(__dirname, "..", "bin"); /** * If the input directory doesn't exist, throw an error. */ if (!existsSync(input)) { throw new Error(`The input directory "${input}" does not exist.`); } const promises = [LambdaFS.inflate(`${input}/chromium.br`)]; if (this.graphicsStackMode) { // Only inflate graphics stack if needed promises.push(LambdaFS.inflate(`${input}/swiftshader.tar.br`)); } if (isRunningInAwsLambda()) { promises.push(LambdaFS.inflate(`${input}/aws.tar.br`)); } const result = await Promise.all(promises); return result.shift() as string; } /** * Returns the headless mode. * `true` means the 'old' (legacy, chromium < 112) headless mode. * "new" means the 'new' headless mode. * https://developer.chrome.com/articles/new-headless/#try-out-the-new-headless * @returns true | "new" */ public static get headless() { return this.headlessMode; } /** * Sets the headless mode. * `true` means the 'old' (legacy, chromium < 112) headless mode. * "new" means the 'new' headless mode. * https://developer.chrome.com/articles/new-headless/#try-out-the-new-headless * @default "new" */ public static set setHeadlessMode(value: true | "new") { this.headlessMode = value; } } export = Chromium;