webdriver 8.13.13 → 8.14.0

package/build/command.d.ts

@@ -1,9 +1,12 @@
+/// <reference types="node" />
+import type { ChildProcess } from 'node:child_process';
 import type { CommandEndpoint, BidiResponse } from '@wdio/protocols';
 import type { BidiHandler } from './bidi/handler.js';
 import type { WebDriverResponse } from './request/index.js';
 import type { BaseClient } from './types.js';
 interface BaseClientWithEventHandler extends BaseClient {
     eventMiddleware: BidiHandler;
+    _driverProcess?: ChildProcess;
 }
 export default function (method: string, endpointUri: string, commandInfo: CommandEndpoint, doubleEncodeVariables?: boolean): (this: BaseClientWithEventHandler, ...args: any[]) => Promise<WebDriverResponse | BidiResponse | void>;
 export {};

package/build/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAK5C,UAAU,0BAA2B,SAAQ,UAAU;IACnD,eAAe,EAAE,WAAW,CAAA;CAC/B;AAED,MAAM,CAAC,OAAO,WACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,eAAe,EAC5B,qBAAqB,UAAQ,UAIgB,0BAA0B,WAAW,GAAG,EAAE,KAAG,QAAQ,iBAAiB,GAAG,YAAY,GAAG,IAAI,CAAC,CA6G7I"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAK5C,UAAU,0BAA2B,SAAQ,UAAU;IACnD,eAAe,EAAE,WAAW,CAAA;IAC5B,cAAc,CAAC,EAAE,YAAY,CAAA;CAChC;AAED,MAAM,CAAC,OAAO,WACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,eAAe,EAC5B,qBAAqB,UAAQ,UAIgB,0BAA0B,WAAW,GAAG,EAAE,KAAG,QAAQ,iBAAiB,GAAG,YAAY,GAAG,IAAI,CAAC,CA0I7I"}

package/build/command.js

@@ -91,8 +91,35 @@ export default function (method, endpointUri, commandInfo, doubleEncodeVariables
                 log.info('RESULT', resultLog);
             }
             this.emit('result', { method, endpoint, body, result });
-            if (command === 'deleteSession' && !process.env.WDIO_WORKER_ID) {
-                logger.clearLogger();
+            if (command === 'deleteSession') {
+                /**
+                 * kill driver process if there is one
+                 */
+                if (this._driverProcess) {
+                    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) {
+                        log.warn('Failed to kill driver process, manully clean-up might be required');
+                    }
+                    this._driverProcess = undefined;
+                    setTimeout(() => {
+                        /**
+                         * clear up potential leaked TLS Socket handles
+                         * see https://github.com/puppeteer/puppeteer/pull/10667
+                         */
+                        for (const handle of process._getActiveHandles()) {
+                            if (handle.servername && handle.servername.includes('edgedl.me')) {
+                                handle.destroy();
+                            }
+                        }
+                    }, 10);
+                }
+                /**
+                 * clear logger stream if session has been terminated
+                 */
+                if (!process.env.WDIO_WORKER_ID) {
+                    logger.clearLogger();
+                }
             }
             return result.value;
         });

package/build/constants.d.ts

@@ -4,4 +4,10 @@ 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":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CA0IpE,CAAA;AAED,eAAO,MAAM,QAAQ;;;CAGpB,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;AAED,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAA"}

package/build/constants.js

@@ -1,3 +1,4 @@
+import os from 'node:os';
 export const DEFAULTS = {
     /**
      * protocol of automation driver
@@ -12,14 +13,13 @@ export const DEFAULTS = {
      */
     hostname: {
         type: 'string',
-        default: 'localhost'
+        default: '0.0.0.0'
     },
     /**
      * port of automation driver
      */
     port: {
-        type: 'number',
-        default: 4444
+        type: 'number'
     },
     /**
      * path to WebDriver endpoints
@@ -134,9 +134,23 @@ export const DEFAULTS = {
     strictSSL: {
         type: 'boolean',
         default: true
+    },
+    /**
+     * The path to the root of the cache directory. This directory is used to store all drivers that are downloaded
+     * when attempting to start a session.
+     */
+    cacheDir: {
+        type: 'string',
+        default: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()
     }
 };
 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/driver/index.d.ts

@@ -0,0 +1,19 @@
+/// <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

@@ -0,0 +1 @@
+{"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,wCAqI/D"}

package/build/driver/index.js

@@ -0,0 +1,138 @@
+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 logFile = path.resolve(options.outputDir, `wdio-${driver.split(' ').shift()?.toLowerCase()}-${port}.log`);
+        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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,108 @@
+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));
+}

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;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;IAsDlB;;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;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"}

package/build/index.js

@@ -3,6 +3,7 @@ import logger from '@wdio/logger';
 import { webdriverMonad, sessionEnvironmentDetector } 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,11 +24,15 @@ export default class WebDriver {
         }
         log.info('Initiate new session using the WebDriver protocol');
         const requestedCapabilities = { ...params.capabilities };
+        const driverProcess = await startWebDriver(params);
         const { sessionId, capabilities } = await startWebDriverSession(params);
         const environment = sessionEnvironmentDetector({ capabilities, requestedCapabilities });
         const environmentPrototype = getEnvironmentVars(environment);
         const protocolCommands = getPrototype(environment);
-        const prototype = { ...protocolCommands, ...environmentPrototype, ...userPrototype };
+        const driverPrototype = {
+            _driverProcess: { value: driverProcess, configurable: false, writable: true }
+        };
+        const prototype = { ...protocolCommands, ...environmentPrototype, ...userPrototype, ...driverPrototype };
         const monad = webdriverMonad({ ...params, requestedCapabilities }, modifier, prototype);
         let handler;
         if (capabilities.webSocketUrl) {

package/build/utils.js

@@ -268,7 +268,7 @@ export const getSessionError = (err, params = {}) => {
     // browser driver / service is not started
     if (err.code === 'ECONNREFUSED') {
         return `Unable to connect to "${params.protocol}://${params.hostname}:${params.port}${params.path}", make sure browser driver is running on that address.` +
-            '\nIf you use services like chromedriver see initialiseServices logs above or in wdio.log file as the service might had problems to start the driver.';
+            '\nIt seems like the service failed to start or is rejecting any connections.';
     }
     if (err.message === 'unhandled request') {
         return 'The browser driver couldn\'t start the session. Make sure you have set the "path" correctly!';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webdriver",
-  "version": "8.13.13",
+  "version": "8.14.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,17 +36,25 @@
     "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.13.13",
+    "@wdio/config": "8.14.0",
     "@wdio/logger": "8.11.0",
     "@wdio/protocols": "8.11.0",
-    "@wdio/types": "8.10.4",
-    "@wdio/utils": "8.13.13",
-    "deepmerge-ts": "^5.0.0",
+    "@wdio/types": "8.14.0",
+    "@wdio/utils": "8.14.0",
+    "chrome-launcher": "^1.0.0",
+    "decamelize": "^6.0.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": "ba97a49a1294e812ed35fc05be20dd29133ab200"
+  "gitHead": "cb2092b007e6d2ac23a49aa30dae67d70e45906d"
 }