webdriver 8.14.3 → 8.15.0

package/build/command.js

@@ -95,7 +95,7 @@ export default function (method, endpointUri, commandInfo, doubleEncodeVariables
                 /**
                  * kill driver process if there is one
                  */
-                if (this._driverProcess) {
+                if (this._driverProcess && body.deleteSessionOpts?.shutdownDriver !== false) {
                     log.info(`Kill ${this._driverProcess.spawnfile} driver process with command line: ${this._driverProcess.spawnargs.slice(1).join(' ')}`);
                     const killedSuccessfully = this._driverProcess.kill('SIGKILL');
                     if (!killedSuccessfully) {

package/build/constants.d.ts

@@ -4,10 +4,4 @@ export declare const REG_EXPS: {
     commandName: RegExp;
     execFn: RegExp;
 };
-export declare const SUPPORTED_BROWSERNAMES: {
-    chrome: string[];
-    firefox: string[];
-    edge: string[];
-    safari: string[];
-};
 //# sourceMappingURL=constants.d.ts.map

package/build/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAiJpE,CAAA;AAED,eAAO,MAAM,QAAQ;;;CAGpB,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAiJpE,CAAA;AAED,eAAO,MAAM,QAAQ;;;CAGpB,CAAA"}

package/build/constants.js

@@ -148,9 +148,3 @@ export const REG_EXPS = {
     commandName: /.*\/session\/[0-9a-f-]+\/(.*)/,
     execFn: /return \(([\s\S]*)\)\.apply\(null, arguments\)/
 };
-export const SUPPORTED_BROWSERNAMES = {
-    chrome: ['chrome', 'googlechrome', 'chromium', 'chromium-browser'],
-    firefox: ['firefox', 'ff', 'mozilla', 'mozilla firefox'],
-    edge: ['edge', 'microsoftedge', 'msedge'],
-    safari: ['safari', 'safari technology preview']
-};

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAExD,OAAO,OAAO,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAyB,YAAY,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAA;AACxG,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAA;AAIrE,MAAM,CAAC,OAAO,OAAO,SAAS;WACb,UAAU,CACnB,OAAO,EAAE,OAAO,CAAC,SAAS,EAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,aAAa,KAAK,EAClB,oBAAoB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC/C,OAAO,CAAC,MAAM,CAAC;IAyDlB;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,OAAO,CAAC,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,aAAa,KAAK,EAClB,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACzC,MAAM;IA0BT;;;;;;OAMG;WACU,aAAa,CAAC,QAAQ,EAAE,MAAM;IAW3C,MAAM,KAAK,SAAS,qBAEnB;CACJ;AAED;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAC9D,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,aAAa,CAAA;AAExD,OAAO,OAAO,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAyB,YAAY,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAA;AACxG,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAA;AAIrE,MAAM,CAAC,OAAO,OAAO,SAAS;WACb,UAAU,CACnB,OAAO,EAAE,OAAO,CAAC,SAAS,EAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,aAAa,KAAK,EAClB,oBAAoB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC/C,OAAO,CAAC,MAAM,CAAC;IAyDlB;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,OAAO,CAAC,EAAE,aAAa,EACvB,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,aAAa,KAAK,EAClB,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GACzC,MAAM;IA0BT;;;;;;OAMG;WACU,aAAa,CAAC,QAAQ,EAAE,MAAM;IAW3C,MAAM,KAAK,SAAS,qBAEnB;CACJ;AAED;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAC9D,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}

package/build/index.js

@@ -1,9 +1,8 @@
 import path from 'node:path';
 import logger from '@wdio/logger';
-import { webdriverMonad, sessionEnvironmentDetector } from '@wdio/utils';
+import { webdriverMonad, sessionEnvironmentDetector, startWebDriver } from '@wdio/utils';
 import { validateConfig } from '@wdio/config';
 import command from './command.js';
-import { startWebDriver } from './driver/index.js';
 import { BidiHandler } from './bidi/handler.js';
 import { DEFAULTS } from './constants.js';
 import { startWebDriverSession, getPrototype, getEnvironmentVars, setupDirectConnect } from './utils.js';
@@ -23,8 +22,8 @@ export default class WebDriver {
             process.env.WDIO_LOG_PATH = path.join(params.outputDir, 'wdio.log');
         }
         log.info('Initiate new session using the WebDriver protocol');
-        const requestedCapabilities = { ...params.capabilities };
         const driverProcess = await startWebDriver(params);
+        const requestedCapabilities = { ...params.capabilities };
         const { sessionId, capabilities } = await startWebDriverSession(params);
         const environment = sessionEnvironmentDetector({ capabilities, requestedCapabilities });
         const environmentPrototype = getEnvironmentVars(environment);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webdriver",
-  "version": "8.14.3",
+  "version": "8.15.0",
   "description": "A Node.js bindings implementation for the W3C WebDriver and Mobile JSONWire Protocol",
   "author": "Christian Bromann <mail@bromann.dev>",
   "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/webdriver",
@@ -36,25 +36,17 @@
     "url": "https://github.com/webdriverio/webdriverio/issues"
   },
   "dependencies": {
-    "@puppeteer/browsers": "^1.4.6",
     "@types/node": "^20.1.0",
     "@types/ws": "^8.5.3",
-    "@wdio/config": "8.14.0",
+    "@wdio/config": "8.15.0",
     "@wdio/logger": "8.11.0",
-    "@wdio/protocols": "8.11.0",
-    "@wdio/types": "8.14.0",
-    "@wdio/utils": "8.14.0",
-    "chrome-launcher": "^1.0.0",
-    "decamelize": "^6.0.0",
+    "@wdio/protocols": "8.14.6",
+    "@wdio/types": "8.15.0",
+    "@wdio/utils": "8.15.0",
     "deepmerge-ts": "^5.1.0",
-    "edgedriver": "^5.3.2",
-    "geckodriver": "^4.1.3",
-    "get-port": "^7.0.0",
     "got": "^ 12.6.1",
     "ky": "^0.33.0",
-    "safaridriver": "^0.1.0",
-    "wait-port": "^1.0.4",
     "ws": "^8.8.0"
   },
-  "gitHead": "5229517c22d25975c0e5dd3207b307f770b87605"
+  "gitHead": "78e199c5ffd74bdf3a5576952c3834c29afa989f"
 }

package/build/driver/index.d.ts

@@ -1,19 +0,0 @@
-/// <reference types="node" />
-import cp from 'node:child_process';
-import type { Options } from '@wdio/types';
-import { type SafaridriverOptions } from 'safaridriver';
-import { type GeckodriverParameters } from 'geckodriver';
-import { type EdgedriverParameters } from 'edgedriver';
-import { type InstallOptions } from '@puppeteer/browsers';
-import type { Capabilities } from '@wdio/types';
-export interface ExtendedCapabilities extends Capabilities.Capabilities, WDIODriverOptions {
-}
-export type ChromedriverOptions = InstallOptions & Omit<EdgedriverParameters, 'port' | 'edgeDriverVersion' | 'customEdgeDriverPath'>;
-export interface WDIODriverOptions {
-    'wdio:chromedriverOptions'?: ChromedriverOptions;
-    'wdio:safaridriverOptions'?: Omit<SafaridriverOptions, 'port'>;
-    'wdio:geckodriverOptions'?: Omit<GeckodriverParameters, 'port'>;
-    'wdio:edgedriverOptions'?: Omit<EdgedriverParameters, 'port'>;
-}
-export declare function startWebDriver(options: Options.WebDriver): Promise<cp.ChildProcess | undefined>;
-//# sourceMappingURL=index.d.ts.map

package/build/driver/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAyB,MAAM,oBAAoB,CAAA;AAM1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACnF,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnF,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,EAA2C,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAElG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO/C,MAAM,WAAW,oBAAqB,SAAQ,YAAY,CAAC,YAAY,EAAE,iBAAiB;CAAG;AAC7F,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,mBAAmB,GAAG,sBAAsB,CAAC,CAAA;AAEpI,MAAM,WAAW,iBAAiB;IAC9B,0BAA0B,CAAC,EAAE,mBAAmB,CAAA;IAChD,0BAA0B,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAC9D,yBAAyB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IAC/D,wBAAwB,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAA;CAChE;AAED,wBAAsB,cAAc,CAAE,OAAO,EAAE,OAAO,CAAC,SAAS,wCAyI/D"}

package/build/driver/index.js

@@ -1,142 +0,0 @@
-import fs from 'node:fs';
-import fsp from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-import cp from 'node:child_process';
-import getPort from 'get-port';
-import waitPort from 'wait-port';
-import logger from '@wdio/logger';
-import { deepmerge } from 'deepmerge-ts';
-import { start as startSafaridriver } from 'safaridriver';
-import { start as startGeckodriver } from 'geckodriver';
-import { start as startEdgedriver } from 'edgedriver';
-import { install, computeExecutablePath, Browser } from '@puppeteer/browsers';
-import { parseParams, setupChrome, definesRemoteDriver, downloadProgressCallback } from './utils.js';
-import { SUPPORTED_BROWSERNAMES } from '../constants.js';
-const log = logger('webdriver');
-export async function startWebDriver(options) {
-    /**
-     * in case we are running unit tests, just return
-     */
-    if (process.env.WDIO_SKIP_DRIVER_SETUP) {
-        options.hostname = '0.0.0.0';
-        options.port = 4321;
-        return;
-    }
-    /**
-     * if any of the connection parameter are set, don't start any driver
-     */
-    if (definesRemoteDriver(options)) {
-        log.info(`Connecting to existing driver at ${options.protocol}://${options.hostname}:${options.port}${options.path}`);
-        return;
-    }
-    let driverProcess;
-    let driver = '';
-    const start = Date.now();
-    const caps = options.capabilities.alwaysMatch || options.capabilities;
-    /**
-     * session might be a mobile session so don't do anything
-     */
-    if (!caps.browserName) {
-        throw new Error('No "browserName" defined in capabilities nor hostname or port found!\n' +
-            'If you like to run a mobile session with Appium, make sure to set "hostname" and "port" in your ' +
-            'WebdriverIO options. If you like to run a local browser session make sure to pick from one of ' +
-            `the following browser names: ${Object.values(SUPPORTED_BROWSERNAMES).flat(Infinity)}`);
-    }
-    const port = await getPort();
-    if (SUPPORTED_BROWSERNAMES.chrome.includes(caps.browserName.toLowerCase())) {
-        /**
-         * Chrome
-         */
-        const chromedriverOptions = caps['wdio:chromedriverOptions'] || {};
-        const cacheDir = chromedriverOptions.cacheDir || options.cacheDir || os.tmpdir();
-        const exist = await fsp.access(cacheDir).then(() => true, () => false);
-        if (!exist) {
-            await fsp.mkdir(cacheDir, { recursive: true });
-        }
-        const { executablePath, buildId, platform } = await setupChrome(caps, cacheDir);
-        const chromedriverBinaryPath = computeExecutablePath({
-            browser: Browser.CHROMEDRIVER,
-            buildId,
-            cacheDir
-        });
-        const hasChromedriverInstalled = await fsp.access(chromedriverBinaryPath).then(() => true, () => false);
-        if (!hasChromedriverInstalled) {
-            log.info(`Downloading Chromedriver v${buildId}`);
-            await install({
-                ...chromedriverOptions,
-                cacheDir,
-                platform,
-                buildId,
-                browser: Browser.CHROMEDRIVER,
-                downloadProgressCallback: (downloadedBytes, totalBytes) => downloadProgressCallback('Chromedriver', downloadedBytes, totalBytes)
-            });
-        }
-        else {
-            log.info(`Using Chromedriver v${buildId} from cache directory ${cacheDir}`);
-        }
-        caps['goog:chromeOptions'] = deepmerge({ binary: executablePath }, caps['goog:chromeOptions'] || {});
-        chromedriverOptions.allowedOrigins = chromedriverOptions.allowedOrigins || ['*'];
-        chromedriverOptions.allowedIps = chromedriverOptions.allowedIps || [''];
-        const driverParams = parseParams({ port, ...chromedriverOptions });
-        driverProcess = cp.spawn(chromedriverBinaryPath, driverParams);
-        driver = `ChromeDriver v${buildId} with params ${driverParams.join(' ')}`;
-    }
-    else if (SUPPORTED_BROWSERNAMES.safari.includes(caps.browserName.toLowerCase())) {
-        const safaridriverOptions = caps['wdio:safaridriverOptions'] || {};
-        /**
-         * Safari
-         */
-        driver = 'SafariDriver';
-        driverProcess = startSafaridriver({
-            useTechnologyPreview: Boolean(caps.browserName.match(/preview/i)),
-            ...safaridriverOptions,
-            port
-        });
-        /**
-         * set "Host" header as it is required by Safaridriver
-         */
-        options.headers = deepmerge({ Host: 'localhost' }, (options.headers || {}));
-    }
-    else if (SUPPORTED_BROWSERNAMES.firefox.includes(caps.browserName.toLowerCase())) {
-        /**
-         * Firefox
-         */
-        const geckodriverOptions = caps['wdio:geckodriverOptions'] || {};
-        const cacheDir = geckodriverOptions.cacheDir || options.cacheDir || os.tmpdir();
-        driver = 'GeckoDriver';
-        driverProcess = await startGeckodriver({ ...geckodriverOptions, cacheDir, port });
-    }
-    else if (SUPPORTED_BROWSERNAMES.edge.includes(caps.browserName.toLowerCase())) {
-        /**
-         * Microsoft Edge
-         */
-        const edgedriverOptions = caps['wdio:edgedriverOptions'] || {};
-        const cacheDir = edgedriverOptions.cacheDir || options.cacheDir || os.tmpdir();
-        driver = 'EdgeDriver';
-        driverProcess = await startEdgedriver({ ...edgedriverOptions, cacheDir, port });
-        /**
-         * Microsoft Edge is very particular when it comes to browser names
-         */
-        caps.browserName = 'MicrosoftEdge';
-    }
-    else {
-        throw new Error(`Unknown browser name "${caps.browserName}". Make sure to pick from one of the following ` +
-            Object.values(SUPPORTED_BROWSERNAMES).flat(Infinity));
-    }
-    if (options.outputDir) {
-        const logIdentifier = driver.split(' ').shift()?.toLowerCase();
-        const logFileName = process.env.WDIO_WORKER_ID
-            ? `wdio-${process.env.WDIO_WORKER_ID}-${logIdentifier}.log`
-            : `wdio-${logIdentifier}-${port}.log`;
-        const logFile = path.resolve(options.outputDir, logFileName);
-        const logStream = fs.createWriteStream(logFile, { flags: 'w' });
-        driverProcess.stdout?.pipe(logStream);
-        driverProcess.stderr?.pipe(logStream);
-    }
-    await waitPort({ port, output: 'silent' });
-    options.hostname = '0.0.0.0';
-    options.port = port;
-    log.info(`Started ${driver} in ${Date.now() - start}ms on port ${port}`);
-    return driverProcess;
-}

package/build/driver/utils.d.ts

@@ -1,18 +0,0 @@
-import type { EdgedriverParameters } from 'edgedriver';
-import type { Capabilities, Options } from '@wdio/types';
-export declare function parseParams(params: EdgedriverParameters): string[];
-export declare function getLocalChromePath(): string | undefined;
-export declare function getBuildIdByPath(chromePath?: string): string | undefined;
-export declare const downloadProgressCallback: (artifact: string, downloadedBytes: number, totalBytes: number) => void;
-export declare function setupChrome(caps: Capabilities.Capabilities, cacheDir: string): Promise<{
-    platform: import("@puppeteer/browsers").BrowserPlatform;
-    executablePath: string;
-    buildId: string;
-}>;
-/**
- * helper method to determine if we need to start a browser driver
- * which is: whenever the user has set connection options that differ from
- * the default, or a port is set
- */
-export declare function definesRemoteDriver(options: Options.WebDriver): boolean;
-//# sourceMappingURL=utils.d.ts.map

package/build/driver/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/driver/utils.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAOxD,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,YAYvD;AAED,wBAAgB,kBAAkB,uBAOjC;AAED,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,sBAenD;AAGD,eAAO,MAAM,wBAAwB,aAAc,MAAM,mBAAmB,MAAM,cAAc,MAAM,SAOrG,CAAA;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM;;;;GA2ClF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,WAO7D"}

package/build/driver/utils.js

@@ -1,108 +0,0 @@
-import os from 'node:os';
-import fs from 'node:fs';
-import path from 'node:path';
-import cp from 'node:child_process';
-import decamelize from 'decamelize';
-import logger from '@wdio/logger';
-import { getChromePath } from 'chrome-launcher';
-import { install, canDownload, resolveBuildId, detectBrowserPlatform, Browser, ChromeReleaseChannel, computeExecutablePath } from '@puppeteer/browsers';
-import { DEFAULTS } from '../constants.js';
-const log = logger('webdriver');
-const EXCLUDED_PARAMS = ['version', 'help'];
-export function parseParams(params) {
-    return Object.entries(params)
-        .filter(([key,]) => !EXCLUDED_PARAMS.includes(key))
-        .map(([key, val]) => {
-        if (typeof val === 'boolean' && !val) {
-            return '';
-        }
-        const vals = Array.isArray(val) ? val : [val];
-        return vals.map((v) => `--${decamelize(key, { separator: '-' })}${typeof v === 'boolean' ? '' : `=${v}`}`);
-    })
-        .flat()
-        .filter(Boolean);
-}
-export function getLocalChromePath() {
-    try {
-        const chromePath = getChromePath();
-        return chromePath;
-    }
-    catch (err) {
-        return;
-    }
-}
-export function getBuildIdByPath(chromePath) {
-    if (!chromePath) {
-        return;
-    }
-    else if (os.platform() === 'win32') {
-        const versionPath = path.dirname(chromePath);
-        const contents = fs.readdirSync(versionPath);
-        const versions = contents.filter(a => /^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$/g.test(a));
-        // returning oldest in case there is an updated version and chrome still hasn't relaunched
-        const oldest = versions.sort((a, b) => a > b ? -1 : 1)[0];
-        return oldest;
-    }
-    const versionString = cp.execSync(`"${chromePath}" --version`).toString();
-    return versionString.split(' ').pop()?.trim();
-}
-let lastTimeCalled = Date.now();
-export const downloadProgressCallback = (artifact, downloadedBytes, totalBytes) => {
-    if (Date.now() - lastTimeCalled < 1000) {
-        return;
-    }
-    const percentage = ((downloadedBytes / totalBytes) * 100).toFixed(2);
-    log.info(`Downloading ${artifact} ${percentage}%`);
-    lastTimeCalled = Date.now();
-};
-export async function setupChrome(caps, cacheDir) {
-    const platform = detectBrowserPlatform();
-    if (!platform) {
-        throw new Error('The current platform is not supported.');
-    }
-    if (!caps.browserVersion) {
-        const executablePath = getLocalChromePath();
-        const tag = getBuildIdByPath(executablePath);
-        /**
-         * verify that we have a valid Chrome browser installed
-         */
-        if (tag) {
-            return {
-                platform,
-                executablePath,
-                buildId: await resolveBuildId(Browser.CHROME, platform, tag)
-            };
-        }
-    }
-    /**
-     * otherwise download provided Chrome browser version or "stable"
-     */
-    const tag = caps.browserVersion || ChromeReleaseChannel.STABLE;
-    const buildId = await resolveBuildId(Browser.CHROME, platform, tag);
-    const installOptions = {
-        cacheDir,
-        platform,
-        buildId,
-        browser: Browser.CHROME,
-        downloadProgressCallback: (downloadedBytes, totalBytes) => downloadProgressCallback('Chrome', downloadedBytes, totalBytes)
-    };
-    const isCombinationAvailable = await canDownload(installOptions);
-    if (!isCombinationAvailable) {
-        throw new Error(`Couldn't find a matching Chrome browser for tag "${buildId}" on platform "${platform}"`);
-    }
-    log.info(`Setting up Chrome v${buildId}`);
-    await install(installOptions);
-    const executablePath = computeExecutablePath(installOptions);
-    return { executablePath, buildId, platform };
-}
-/**
- * helper method to determine if we need to start a browser driver
- * which is: whenever the user has set connection options that differ from
- * the default, or a port is set
- */
-export function definesRemoteDriver(options) {
-    return Boolean((options.protocol && options.protocol !== DEFAULTS.protocol.default) ||
-        (options.hostname && options.hostname !== DEFAULTS.hostname.default) ||
-        Boolean(options.port) ||
-        (options.path && options.path !== DEFAULTS.path.default));
-}