/** * Copyright (c) Microsoft Corporation. * * 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 { BrowserContext } from '../browserContext'; import { BrowserServer } from './browserServer'; import * as browserPaths from '../install/browserPaths'; import { Logger } from '../logger'; export type BrowserArgOptions = { headless?: boolean, args?: string[], devtools?: boolean, }; type LaunchOptionsBase = BrowserArgOptions & { executablePath?: string, ignoreDefaultArgs?: boolean | string[], handleSIGINT?: boolean, handleSIGTERM?: boolean, handleSIGHUP?: boolean, timeout?: number, logger?: Logger, env?: {[key: string]: string|number|boolean} }; export function processBrowserArgOptions(options: LaunchOptionsBase): { devtools: boolean, headless: boolean } { const { devtools = false, headless = !devtools } = options; return { devtools, headless }; } export type ConnectOptions = { wsEndpoint: string, slowMo?: number, logger?: Logger, }; export type LaunchOptions = LaunchOptionsBase & { slowMo?: number }; export type LaunchServerOptions = LaunchOptionsBase & { port?: number }; export interface BrowserType { executablePath(): string; name(): string; launch(options?: LaunchOptions): Promise; launchServer(options?: LaunchServerOptions): Promise; launchPersistentContext(userDataDir: string, options?: LaunchOptions): Promise; connect(options: ConnectOptions): Promise; } export abstract class AbstractBrowserType implements BrowserType { private _name: string; private _executablePath: string | undefined; constructor(packagePath: string, browser: browserPaths.BrowserDescriptor) { this._name = browser.name; const browsersPath = browserPaths.browsersPath(packagePath); const browserPath = browserPaths.browserDirectory(browsersPath, browser); this._executablePath = browserPaths.executablePath(browserPath, browser); } executablePath(): string { if (!this._executablePath) throw new Error('Browser is not supported on current platform'); return this._executablePath; } name(): string { return this._name; } abstract launch(options?: LaunchOptions): Promise; abstract launchServer(options?: LaunchServerOptions): Promise; abstract launchPersistentContext(userDataDir: string, options?: LaunchOptions): Promise; abstract connect(options: ConnectOptions): Promise; }