/** * Copyright 2017 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. */ const Launcher = require('./Launcher'); const BrowserFetcher = require('./BrowserFetcher'); const Errors = require('./Errors'); const DeviceDescriptors = require('./DeviceDescriptors'); module.exports = class { /** * @param {string} projectRoot * @param {string} preferredRevision * @param {boolean} isPuppeteerCore */ constructor(projectRoot, preferredRevision, isPuppeteerCore) { this._projectRoot = projectRoot; this._preferredRevision = preferredRevision; this._isPuppeteerCore = isPuppeteerCore; } /** * @param {!(Launcher.LaunchOptions & Launcher.ChromeArgOptions & Launcher.BrowserOptions & {product?: string, extraPrefsFirefox?: !object})=} options * @return {!Promise} */ launch(options = {}) { this._productName = options.product; return this._launcher.launch(options); } /** * @param {!(Launcher.BrowserOptions & {browserWSEndpoint?: string, browserURL?: string, transport?: !Puppeteer.ConnectionTransport})} options * @return {!Promise} */ connect(options) { return this._launcher.connect(options); } /** * @return {string} */ executablePath() { return this._launcher.executablePath(); } /** * @return {!Puppeteer.ProductLauncher} */ get _launcher() { if (!this._lazyLauncher || this._lazyLauncher.product !== this._productName) { // @ts-ignore const packageJson = require('../package.json'); switch (this._productName) { case 'firefox': this._preferredRevision = packageJson.puppeteer.firefox_revision; break; case 'chrome': default: this._preferredRevision = packageJson.puppeteer.chromium_revision; } this._lazyLauncher = Launcher(this._projectRoot, this._preferredRevision, this._isPuppeteerCore, this._productName); } return this._lazyLauncher; } /** * @return {string} */ get product() { return this._launcher.product; } /** * @return {Object} */ get devices() { return DeviceDescriptors; } /** * @return {Object} */ get errors() { return Errors; } /** * @param {!Launcher.ChromeArgOptions=} options * @return {!Array} */ defaultArgs(options) { return this._launcher.defaultArgs(options); } /** * @param {!BrowserFetcher.Options=} options * @return {!BrowserFetcher} */ createBrowserFetcher(options) { return new BrowserFetcher(this._projectRoot, options); } };