/** * @license * Copyright 2023 Google Inc. * SPDX-License-Identifier: Apache-2.0 */ import * as chromeHeadlessShell from './chrome-headless-shell.js'; import * as chrome from './chrome.js'; import * as chromedriver from './chromedriver.js'; import * as chromium from './chromium.js'; import * as firefox from './firefox.js'; import { Browser, BrowserPlatform, BrowserTag, ChromeReleaseChannel, type ProfileOptions, } from './types.js'; export type {ProfileOptions}; export const downloadUrls = { [Browser.CHROMEDRIVER]: chromedriver.resolveDownloadUrl, [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.resolveDownloadUrl, [Browser.CHROME]: chrome.resolveDownloadUrl, [Browser.CHROMIUM]: chromium.resolveDownloadUrl, [Browser.FIREFOX]: firefox.resolveDownloadUrl, }; export const downloadPaths = { [Browser.CHROMEDRIVER]: chromedriver.resolveDownloadPath, [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.resolveDownloadPath, [Browser.CHROME]: chrome.resolveDownloadPath, [Browser.CHROMIUM]: chromium.resolveDownloadPath, [Browser.FIREFOX]: firefox.resolveDownloadPath, }; export const executablePathByBrowser = { [Browser.CHROMEDRIVER]: chromedriver.relativeExecutablePath, [Browser.CHROMEHEADLESSSHELL]: chromeHeadlessShell.relativeExecutablePath, [Browser.CHROME]: chrome.relativeExecutablePath, [Browser.CHROMIUM]: chromium.relativeExecutablePath, [Browser.FIREFOX]: firefox.relativeExecutablePath, }; export {Browser, BrowserPlatform, ChromeReleaseChannel}; /** * @public */ export async function resolveBuildId( browser: Browser, platform: BrowserPlatform, tag: string ): Promise { switch (browser) { case Browser.FIREFOX: switch (tag as BrowserTag) { case BrowserTag.LATEST: return await firefox.resolveBuildId('FIREFOX_NIGHTLY'); case BrowserTag.BETA: case BrowserTag.CANARY: case BrowserTag.DEV: case BrowserTag.STABLE: throw new Error( `${tag} is not supported for ${browser}. Use 'latest' instead.` ); } case Browser.CHROME: { switch (tag as BrowserTag) { case BrowserTag.LATEST: return await chrome.resolveBuildId(ChromeReleaseChannel.CANARY); case BrowserTag.BETA: return await chrome.resolveBuildId(ChromeReleaseChannel.BETA); case BrowserTag.CANARY: return await chrome.resolveBuildId(ChromeReleaseChannel.CANARY); case BrowserTag.DEV: return await chrome.resolveBuildId(ChromeReleaseChannel.DEV); case BrowserTag.STABLE: return await chrome.resolveBuildId(ChromeReleaseChannel.STABLE); default: const result = await chrome.resolveBuildId(tag); if (result) { return result; } } return tag; } case Browser.CHROMEDRIVER: { switch (tag) { case BrowserTag.LATEST: case BrowserTag.CANARY: return await chromedriver.resolveBuildId(ChromeReleaseChannel.CANARY); case BrowserTag.BETA: return await chromedriver.resolveBuildId(ChromeReleaseChannel.BETA); case BrowserTag.DEV: return await chromedriver.resolveBuildId(ChromeReleaseChannel.DEV); case BrowserTag.STABLE: return await chromedriver.resolveBuildId(ChromeReleaseChannel.STABLE); default: const result = await chromedriver.resolveBuildId(tag); if (result) { return result; } } return tag; } case Browser.CHROMEHEADLESSSHELL: { switch (tag) { case BrowserTag.LATEST: case BrowserTag.CANARY: return await chromeHeadlessShell.resolveBuildId( ChromeReleaseChannel.CANARY ); case BrowserTag.BETA: return await chromeHeadlessShell.resolveBuildId( ChromeReleaseChannel.BETA ); case BrowserTag.DEV: return await chromeHeadlessShell.resolveBuildId( ChromeReleaseChannel.DEV ); case BrowserTag.STABLE: return await chromeHeadlessShell.resolveBuildId( ChromeReleaseChannel.STABLE ); default: const result = await chromeHeadlessShell.resolveBuildId(tag); if (result) { return result; } } return tag; } case Browser.CHROMIUM: switch (tag as BrowserTag) { case BrowserTag.LATEST: return await chromium.resolveBuildId(platform); case BrowserTag.BETA: case BrowserTag.CANARY: case BrowserTag.DEV: case BrowserTag.STABLE: throw new Error( `${tag} is not supported for ${browser}. Use 'latest' instead.` ); } } // We assume the tag is the buildId if it didn't match any keywords. return tag; } /** * @public */ export async function createProfile( browser: Browser, opts: ProfileOptions ): Promise { switch (browser) { case Browser.FIREFOX: return await firefox.createProfile(opts); case Browser.CHROME: case Browser.CHROMIUM: throw new Error(`Profile creation is not support for ${browser} yet`); } } /** * @public */ export function resolveSystemExecutablePath( browser: Browser, platform: BrowserPlatform, channel: ChromeReleaseChannel ): string { switch (browser) { case Browser.CHROMEDRIVER: case Browser.CHROMEHEADLESSSHELL: case Browser.FIREFOX: case Browser.CHROMIUM: throw new Error( `System browser detection is not supported for ${browser} yet.` ); case Browser.CHROME: return chrome.resolveSystemExecutablePath(platform, channel); } }