188 lines
5.6 KiB
TypeScript
188 lines
5.6 KiB
TypeScript
|
|
/**
|
||
|
|
* @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<string> {
|
||
|
|
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<void> {
|
||
|
|
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);
|
||
|
|
}
|
||
|
|
}
|