/** * Copyright 2023 Google Inc. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import {mkdtemp} from 'fs/promises'; import path from 'path'; import { computeSystemExecutablePath, Browser as SupportedBrowsers, ChromeReleaseChannel as BrowsersChromeReleaseChannel, } from '@puppeteer/browsers'; import {debugError} from '../common/util.js'; import {assert} from '../util/assert.js'; import {rm} from '../util/fs.js'; import { BrowserLaunchArgumentOptions, ChromeReleaseChannel, PuppeteerNodeLaunchOptions, } from './LaunchOptions.js'; import {ProductLauncher, ResolvedLaunchArgs} from './ProductLauncher.js'; import {PuppeteerNode} from './PuppeteerNode.js'; /** * @internal */ export class ChromeLauncher extends ProductLauncher { constructor(puppeteer: PuppeteerNode) { super(puppeteer, 'chrome'); } /** * @internal */ override async computeLaunchArguments( options: PuppeteerNodeLaunchOptions = {} ): Promise { const { ignoreDefaultArgs = false, args = [], pipe = false, debuggingPort, channel, executablePath, } = options; const chromeArguments = []; if (!ignoreDefaultArgs) { chromeArguments.push(...this.defaultArgs(options)); } else if (Array.isArray(ignoreDefaultArgs)) { chromeArguments.push( ...this.defaultArgs(options).filter(arg => { return !ignoreDefaultArgs.includes(arg); }) ); } else { chromeArguments.push(...args); } if ( !chromeArguments.some(argument => { return argument.startsWith('--remote-debugging-'); }) ) { if (pipe) { assert( !debuggingPort, 'Browser should be launched with either pipe or debugging port - not both.' ); chromeArguments.push('--remote-debugging-pipe'); } else { chromeArguments.push(`--remote-debugging-port=${debuggingPort || 0}`); } } let isTempUserDataDir = false; // Check for the user data dir argument, which will always be set even // with a custom directory specified via the userDataDir option. let userDataDirIndex = chromeArguments.findIndex(arg => { return arg.startsWith('--user-data-dir'); }); if (userDataDirIndex < 0) { isTempUserDataDir = true; chromeArguments.push( `--user-data-dir=${await mkdtemp(this.getProfilePath())}` ); userDataDirIndex = chromeArguments.length - 1; } const userDataDir = chromeArguments[userDataDirIndex]!.split('=', 2)[1]; assert(typeof userDataDir === 'string', '`--user-data-dir` is malformed'); let chromeExecutable = executablePath; if (!chromeExecutable) { assert( channel || !this.puppeteer._isPuppeteerCore, `An \`executablePath\` or \`channel\` must be specified for \`puppeteer-core\`` ); chromeExecutable = this.executablePath(channel); } return { executablePath: chromeExecutable, args: chromeArguments, isTempUserDataDir, userDataDir, }; } /** * @internal */ override async cleanUserDataDir( path: string, opts: {isTemp: boolean} ): Promise { if (opts.isTemp) { try { await rm(path); } catch (error) { debugError(error); throw error; } } } override defaultArgs(options: BrowserLaunchArgumentOptions = {}): string[] { // See https://github.com/GoogleChrome/chrome-launcher/blob/main/docs/chrome-flags-for-tools.md const chromeArguments = [ '--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', // AcceptCHFrame disabled because of crbug.com/1348106. '--disable-features=Translate,BackForwardCache,AcceptCHFrame,MediaRouter,OptimizationHints', '--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', '--enable-features=NetworkServiceInProcess2', '--export-tagged-pdf', '--force-color-profile=srgb', '--metrics-recording-only', '--no-first-run', '--password-store=basic', '--use-mock-keychain', ]; const { devtools = false, headless = !devtools, args = [], userDataDir, } = options; if (userDataDir) { chromeArguments.push(`--user-data-dir=${path.resolve(userDataDir)}`); } if (devtools) { chromeArguments.push('--auto-open-devtools-for-tabs'); } if (headless) { chromeArguments.push( headless === 'new' ? '--headless=new' : '--headless', '--hide-scrollbars', '--mute-audio' ); } if ( args.every(arg => { return arg.startsWith('-'); }) ) { chromeArguments.push('about:blank'); } chromeArguments.push(...args); return chromeArguments; } override executablePath(channel?: ChromeReleaseChannel): string { if (channel) { return computeSystemExecutablePath({ browser: SupportedBrowsers.CHROME, channel: convertPuppeteerChannelToBrowsersChannel(channel), }); } else { return this.resolveExecutablePath(); } } } function convertPuppeteerChannelToBrowsersChannel( channel: ChromeReleaseChannel ): BrowsersChromeReleaseChannel { switch (channel) { case 'chrome': return BrowsersChromeReleaseChannel.STABLE; case 'chrome-dev': return BrowsersChromeReleaseChannel.DEV; case 'chrome-beta': return BrowsersChromeReleaseChannel.BETA; case 'chrome-canary': return BrowsersChromeReleaseChannel.CANARY; } }