appium-mac2-driver 4.5.1 → 4.6.1

package/node_modules/appium-chromedriver/build/lib/chromedriver.js

@@ -0,0 +1,307 @@
+import events from 'node:events';
+import { WebDriverProxy, PROTOCOLS } from '@appium/base-driver';
+import { logger, util } from '@appium/support';
+import { SubProcess, exec } from 'teen_process';
+import { getDriversMapping, getChromedrivers, updateDriversMapping, getCompatibleChromedriver, initChromedriverPath, } from './commands/binary.js';
+import { buildChromedriverArgs, waitForOnline, getStatus, killAll } from './commands/process.js';
+import { syncProtocol, startSession, changeState, getCapValue } from './commands/session.js';
+import { getChromeVersionForAutodetection } from './commands/version.js';
+import { CHROMEDRIVER_EVENTS, CHROMEDRIVER_STATES } from './constants.js';
+import { ChromedriverStorageClient } from './storage-client/storage-client.js';
+import { getChromedriverDir, generateLogPrefix } from './utils.js';
+// Keep this import marked as used at runtime when it is otherwise only referenced in type positions.
+void PROTOCOLS;
+const DEFAULT_HOST = '127.0.0.1';
+const DEFAULT_PORT = 9515;
+// consider chromedriver ready once startup banner appears
+const chromedriverStdoutStartDetector = (stdout) => stdout.startsWith('Starting ');
+export class Chromedriver extends events.EventEmitter {
+    static EVENT_ERROR = CHROMEDRIVER_EVENTS.ERROR;
+    static EVENT_CHANGED = CHROMEDRIVER_EVENTS.CHANGED;
+    static STATE_STOPPED = CHROMEDRIVER_STATES.STOPPED;
+    static STATE_STARTING = CHROMEDRIVER_STATES.STARTING;
+    static STATE_ONLINE = CHROMEDRIVER_STATES.ONLINE;
+    static STATE_STOPPING = CHROMEDRIVER_STATES.STOPPING;
+    static STATE_RESTARTING = CHROMEDRIVER_STATES.RESTARTING;
+    proxyPort;
+    adb;
+    cmdArgs;
+    proc;
+    useSystemExecutable;
+    chromedriver;
+    executableDir;
+    mappingPath;
+    bundleId;
+    executableVerified;
+    state;
+    _execFunc;
+    jwproxy;
+    isCustomExecutableDir;
+    verbose;
+    logPath;
+    disableBuildCheck;
+    storageClient;
+    details;
+    capabilities;
+    _desiredProtocol;
+    _driverVersion;
+    _onlineStatus;
+    _log;
+    proxyHost;
+    buildChromedriverArgs = buildChromedriverArgs;
+    getDriversMapping = getDriversMapping;
+    getChromedrivers = getChromedrivers;
+    updateDriversMapping = updateDriversMapping;
+    getCompatibleChromedriver = getCompatibleChromedriver;
+    initChromedriverPath = initChromedriverPath;
+    getChromeVersion = getChromeVersionForAutodetection;
+    syncProtocol = syncProtocol;
+    waitForOnline = waitForOnline;
+    getStatus = getStatus;
+    killAll = killAll;
+    changeState = changeState;
+    startSession = startSession;
+    constructor(args = {}) {
+        super();
+        const { host = DEFAULT_HOST, port = DEFAULT_PORT, useSystemExecutable = false, executable, executableDir, bundleId, mappingPath, cmdArgs, adb, verbose, logPath, disableBuildCheck, details, isAutodownloadEnabled = false, reqBasePath, } = args;
+        this._log = logger.getLogger(generateLogPrefix(this));
+        this.proxyHost = host;
+        this.proxyPort = parseInt(String(port), 10);
+        this.adb = adb;
+        this.cmdArgs = cmdArgs;
+        this.proc = null;
+        this.useSystemExecutable = useSystemExecutable;
+        this.chromedriver = executable;
+        this.mappingPath = mappingPath;
+        this.bundleId = bundleId;
+        this.executableVerified = false;
+        this.state = Chromedriver.STATE_STOPPED;
+        this._execFunc = exec;
+        const proxyOpts = { server: this.proxyHost, port: this.proxyPort, log: this._log };
+        if (reqBasePath) {
+            proxyOpts.reqBasePath = reqBasePath;
+        }
+        this.jwproxy = new WebDriverProxy(proxyOpts);
+        if (executableDir) {
+            this.executableDir = executableDir;
+            this.isCustomExecutableDir = true;
+        }
+        else {
+            this.executableDir = getChromedriverDir();
+            this.isCustomExecutableDir = false;
+        }
+        this.verbose = verbose;
+        this.logPath = logPath;
+        this.disableBuildCheck = !!disableBuildCheck;
+        this.storageClient = isAutodownloadEnabled
+            ? new ChromedriverStorageClient({ chromedriverDir: this.executableDir })
+            : null;
+        this.details = details;
+        this.capabilities = {};
+        this._desiredProtocol = null;
+        this._driverVersion = null;
+        this._onlineStatus = null;
+    }
+    get log() {
+        return this._log;
+    }
+    get driverVersion() {
+        return this._driverVersion;
+    }
+    /**
+     * Starts a new Chromedriver session with the given capabilities.
+     *
+     * @param caps - Capabilities passed to Chromedriver session creation.
+     * @param emitStartingState - Whether to emit the `starting` state transition.
+     * @returns Session capabilities returned by Chromedriver.
+     */
+    async start(caps, emitStartingState = true) {
+        this.capabilities = this.prepareCapabilitiesForSessionStart(caps);
+        if (emitStartingState) {
+            this.changeState(Chromedriver.STATE_STARTING);
+        }
+        const args = this.buildChromedriverArgs();
+        const webviewVersionHolder = {};
+        try {
+            await this.launchChromedriverProcess(args, webviewVersionHolder);
+            this.syncProtocol();
+            return await this.startSession();
+        }
+        catch (e) {
+            return await this.handleChromedriverStartFailure(e, webviewVersionHolder.version);
+        }
+    }
+    /**
+     * Gets active Chromedriver session id if the driver is online.
+     *
+     * @returns The session id or `null` when driver is not online.
+     */
+    sessionId() {
+        return this.state === Chromedriver.STATE_ONLINE ? this.jwproxy.sessionId : null;
+    }
+    /**
+     * Restarts current Chromedriver session with previously stored capabilities.
+     *
+     * @returns Session capabilities returned by the restarted session.
+     */
+    async restart() {
+        this.log.info('Restarting chromedriver');
+        if (this.state !== Chromedriver.STATE_ONLINE) {
+            throw new Error("Can't restart when we're not online");
+        }
+        this.changeState(Chromedriver.STATE_RESTARTING);
+        await this.stop(false);
+        return await this.start(this.capabilities, false);
+    }
+    /**
+     * Stops the current Chromedriver session and underlying subprocess.
+     *
+     * @param emitStates - Whether to emit stopping/stopped state transitions.
+     */
+    async stop(emitStates = true) {
+        if (emitStates) {
+            this.changeState(Chromedriver.STATE_STOPPING);
+        }
+        const runSafeStep = async (f) => {
+            try {
+                return await f();
+            }
+            catch (e) {
+                const err = e;
+                this.log.warn(err.message);
+                this.log.debug(err.stack);
+            }
+        };
+        await runSafeStep(() => this.jwproxy.command('', 'DELETE'));
+        await runSafeStep(async () => {
+            await this.proc?.stop('SIGTERM', 20000);
+            this.proc?.removeAllListeners();
+            this.proc = null;
+        });
+        this.log.prefix = generateLogPrefix(this);
+        if (emitStates) {
+            this.changeState(Chromedriver.STATE_STOPPED);
+        }
+    }
+    /**
+     * Sends a direct command to Chromedriver through the JSONWP/W3C proxy.
+     *
+     * @param url - Chromedriver endpoint path.
+     * @param method - HTTP method used for the command.
+     * @param body - Optional request payload.
+     * @returns Command response payload.
+     */
+    async sendCommand(url, method, body = null) {
+        return await this.jwproxy.command(url, method, body);
+    }
+    /**
+     * Proxies an incoming Express request/response pair to Chromedriver.
+     *
+     * @param req - Incoming request object.
+     * @param res - Outgoing response object.
+     */
+    async proxyReq(req, res) {
+        await this.jwproxy.proxyReqRes(req, res);
+    }
+    /**
+     * Checks whether the active webview connection is currently responsive.
+     *
+     * @returns `true` if `/url` command succeeds, otherwise `false`.
+     */
+    async hasWorkingWebview() {
+        try {
+            await this.jwproxy.command('/url', 'GET');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    prepareCapabilitiesForSessionStart(caps) {
+        const capabilities = structuredClone(caps);
+        // set the logging preferences to ALL browser console logs by default
+        capabilities.loggingPrefs = structuredClone(getCapValue(caps, 'loggingPrefs', {}));
+        if (util.isEmpty(capabilities.loggingPrefs.browser)) {
+            capabilities.loggingPrefs.browser = 'ALL';
+        }
+        return capabilities;
+    }
+    attachChromedriverProcessListeners(webviewVersionHolder) {
+        const proc = this.proc;
+        if (!proc) {
+            throw new Error('Chromedriver subprocess must be assigned before attaching listeners');
+        }
+        for (const streamName of ['stderr', 'stdout']) {
+            proc.on(`line-${streamName}`, (line) => {
+                // if chromedriver does not print explicit Chrome version support,
+                // infer webview version from DevTools banner for better errors
+                if (!webviewVersionHolder.version) {
+                    const match = /"Browser": "([^"]+)"/.exec(line);
+                    if (match) {
+                        webviewVersionHolder.version = match[1];
+                        this.log.debug(`Webview version: '${webviewVersionHolder.version}'`);
+                    }
+                }
+                if (this.verbose) {
+                    this.log.debug(`[${streamName.toUpperCase()}] ${line}`);
+                }
+            });
+        }
+        proc.once('exit', (code, signal) => {
+            this._driverVersion = null;
+            this._desiredProtocol = null;
+            this._onlineStatus = null;
+            if (this.state !== Chromedriver.STATE_STOPPED &&
+                this.state !== Chromedriver.STATE_STOPPING &&
+                this.state !== Chromedriver.STATE_RESTARTING) {
+                this.log.error(`Chromedriver exited unexpectedly with code ${code}, signal ${signal}`);
+                this.changeState(Chromedriver.STATE_STOPPED);
+            }
+            this.proc?.removeAllListeners();
+            this.proc = null;
+        });
+    }
+    async launchChromedriverProcess(args, webviewVersionHolder) {
+        const chromedriverPath = await this.initChromedriverPath();
+        // remove stale chromedriver/adb-forward leftovers before launching
+        await this.killAll();
+        this.proc = new SubProcess(chromedriverPath, args);
+        this.attachChromedriverProcessListeners(webviewVersionHolder);
+        this.log.info(`Spawning Chromedriver with: ${this.chromedriver} ${args.join(' ')}`);
+        await this.proc.start(chromedriverStdoutStartDetector);
+        // wait until /status says ready, then negotiate protocol and start session
+        await this.waitForOnline();
+    }
+    formatChromeVersionMismatchHint(err, webviewVersion) {
+        if (!err.message.includes('Chrome version must be')) {
+            return '';
+        }
+        // enrich the common version-mismatch error with actionable context
+        let message = 'Unable to automate Chrome version because it is not supported by this version of Chromedriver.\n';
+        if (webviewVersion) {
+            message += `Chrome version on the device: ${webviewVersion}\n`;
+        }
+        const versionsSupportedByDriver = /Chrome version must be (.+)/.exec(err.message)?.[1] || '';
+        if (versionsSupportedByDriver) {
+            message += `Chromedriver supports Chrome version(s): ${versionsSupportedByDriver}\n`;
+        }
+        message += 'Check the driver tutorial for troubleshooting.\n';
+        return message;
+    }
+    async handleChromedriverStartFailure(err, webviewVersion) {
+        this.log.debug(err);
+        this.emit(Chromedriver.EVENT_ERROR, err);
+        // an error does not always mean subprocess has already exited
+        if (this.proc) {
+            try {
+                await this.proc.stop();
+            }
+            catch { }
+        }
+        this.proc?.removeAllListeners();
+        this.proc = null;
+        const message = this.formatChromeVersionMismatchHint(err, webviewVersion) + err.message;
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=chromedriver.js.map

package/node_modules/appium-chromedriver/build/lib/chromedriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromedriver.js","sourceRoot":"","sources":["../../lib/chromedriver.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAC,UAAU,EAAE,IAAI,EAAC,MAAM,cAAc,CAAC;AAE9C,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAC,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAA2B,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAC,gCAAgC,EAAC,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAC,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAC,yBAAyB,EAAC,MAAM,oCAAoC,CAAC;AAE7E,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,YAAY,CAAC;AAEjE,qGAAqG;AACrG,KAAK,SAAS,CAAC;AAGf,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,0DAA0D;AAC1D,MAAM,+BAA+B,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAOpG,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,YAAkC;IACzE,MAAM,CAAU,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC;IACxD,MAAM,CAAU,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAU,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAU,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC;IAC9D,MAAM,CAAU,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1D,MAAM,CAAU,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC;IAC9D,MAAM,CAAU,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC;IAEzD,SAAS,CAAS;IAClB,GAAG,CAAmB;IACtB,OAAO,CAAY;IAC5B,IAAI,CAAoB;IACf,mBAAmB,CAAU;IACtC,YAAY,CAAU;IACb,aAAa,CAAS;IACtB,WAAW,CAAU;IAC9B,QAAQ,CAAU;IAClB,kBAAkB,CAAU;IAC5B,KAAK,CAAS;IACd,SAAS,CAAc;IACvB,OAAO,CAAiB;IACf,qBAAqB,CAAU;IAC/B,OAAO,CAAW;IAClB,OAAO,CAAU;IACjB,iBAAiB,CAAU;IAC3B,aAAa,CAAmC;IAChD,OAAO,CAA+B;IAC/C,YAAY,CAAsB;IAClC,gBAAgB,CAAgC;IAChD,cAAc,CAAgB;IAC9B,aAAa,CAA6B;IAEzB,IAAI,CAAM;IACV,SAAS,CAAS;IAE3B,qBAAqB,GAAG,qBAAqB,CAAC;IAC9C,iBAAiB,GAAG,iBAAiB,CAAC;IACtC,gBAAgB,GAAG,gBAAgB,CAAC;IACpC,oBAAoB,GAAG,oBAAoB,CAAC;IAC5C,yBAAyB,GAAG,yBAAyB,CAAC;IACtD,oBAAoB,GAAG,oBAAoB,CAAC;IAC5C,gBAAgB,GAAG,gCAAgC,CAAC;IACpD,YAAY,GAAG,YAAY,CAAC;IAC5B,aAAa,GAAG,aAAa,CAAC;IAC9B,SAAS,GAAG,SAAS,CAAC;IACtB,OAAO,GAAG,OAAO,CAAC;IAClB,WAAW,GAAG,WAAW,CAAC;IAC1B,YAAY,GAAG,YAAY,CAAC;IAEpC,YAAY,OAAyB,EAAE;QACrC,KAAK,EAAE,CAAC;QACR,MAAM,EACJ,IAAI,GAAG,YAAY,EACnB,IAAI,GAAG,YAAY,EACnB,mBAAmB,GAAG,KAAK,EAC3B,UAAU,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,EACP,iBAAiB,EACjB,OAAO,EACP,qBAAqB,GAAG,KAAK,EAC7B,WAAW,GACZ,GAAG,IAAI,CAAC;QACT,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,MAAM,SAAS,GAAiB,EAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAC,CAAC;QAC/F,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,WAAW,GAAG,WAAW,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;YACnC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,GAAG,kBAAkB,EAAE,CAAC;YAC1C,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,qBAAqB;YACxC,CAAC,CAAC,IAAI,yBAAyB,CAAC,EAAC,eAAe,EAAE,IAAI,CAAC,aAAa,EAAC,CAAC;YACtE,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,IAAyB,EAAE,iBAAiB,GAAG,IAAI;QAC7D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC1C,MAAM,oBAAoB,GAA0B,EAAE,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;YACjE,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,MAAM,IAAI,CAAC,8BAA8B,CAAC,CAAU,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,YAAY,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI;QAC1B,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,EAAE,CAA2B,EAAiB,EAAE;YACvE,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,EAAE,CAAC;YACnB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,CAAU,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QACF,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5D,MAAM,WAAW,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,MAAkB,EAAE,OAAiB,IAAI;QACtE,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAY,EAAE,GAAa;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEO,kCAAkC,CAAC,IAAyB;QAClE,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,qEAAqE;QACrE,YAAY,CAAC,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,YAAY,CAAC,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;QAC5C,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,kCAAkC,CAAC,oBAA2C;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;YACvD,IAAI,CAAC,EAAE,CAAC,QAAQ,UAAU,EAAE,EAAE,CAAC,IAAY,EAAE,EAAE;gBAC7C,kEAAkE;gBAClE,+DAA+D;gBAC/D,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;oBAClC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChD,IAAI,KAAK,EAAE,CAAC;wBACV,oBAAoB,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;wBACxC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC;gBACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,MAAqB,EAAE,EAAE;YAC/D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IACE,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,aAAa;gBACzC,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,cAAc;gBAC1C,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,gBAAgB,EAC5C,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,8CAA8C,IAAI,YAAY,MAAM,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,IAAc,EAAE,oBAA2C;QACjG,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC3D,mEAAmE;QACnE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,kCAAkC,CAAC,oBAAoB,CAAC,CAAC;QAE9D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACvD,2EAA2E;QAC3E,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAEO,+BAA+B,CAAC,GAAU,EAAE,cAAuB;QACzE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,mEAAmE;QACnE,IAAI,OAAO,GAAG,kGAAkG,CAAC;QACjH,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,IAAI,iCAAiC,cAAc,IAAI,CAAC;QACjE,CAAC;QACD,MAAM,yBAAyB,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7F,IAAI,yBAAyB,EAAE,CAAC;YAC9B,OAAO,IAAI,4CAA4C,yBAAyB,IAAI,CAAC;QACvF,CAAC;QACD,OAAO,IAAI,kDAAkD,CAAC;QAC9D,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,8BAA8B,CAAC,GAAU,EAAE,cAAuB;QAC9E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACzC,8DAA8D;QAC9D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,+BAA+B,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC"}

package/node_modules/appium-chromedriver/build/lib/commands/binary.d.ts

@@ -0,0 +1,28 @@
+import type { ChromedriverVersionMapping } from '../types.js';
+import type { ChromedriverCommandContext } from './types.js';
+export interface ChromedriverInfo {
+    executable: string;
+    version: string;
+    minChromeVersion: string | null;
+}
+/**
+ * Loads and normalizes Chromedriver-to-Chrome version mapping.
+ */
+export declare function getDriversMapping(this: ChromedriverCommandContext): Promise<ChromedriverVersionMapping>;
+/**
+ * Discovers available Chromedriver binaries and parses their versions.
+ */
+export declare function getChromedrivers(this: ChromedriverCommandContext, mapping: ChromedriverVersionMapping): Promise<ChromedriverInfo[]>;
+/**
+ * Persists updated version mapping to disk or falls back to in-memory update.
+ */
+export declare function updateDriversMapping(this: ChromedriverCommandContext, newMapping: ChromedriverVersionMapping): Promise<void>;
+/**
+ * Selects the most suitable Chromedriver binary for current environment.
+ */
+export declare function getCompatibleChromedriver(this: ChromedriverCommandContext): Promise<string>;
+/**
+ * Resolves and verifies the effective Chromedriver executable path.
+ */
+export declare function initChromedriverPath(this: ChromedriverCommandContext): Promise<string>;
+//# sourceMappingURL=binary.d.ts.map

package/node_modules/appium-chromedriver/build/lib/commands/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../lib/commands/binary.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,YAAY,CAAC;AAM3D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAUD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA6B7G;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyE7B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,0BAA0B,EAChC,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDjG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB5F"}

package/node_modules/appium-chromedriver/build/lib/commands/binary.js

@@ -0,0 +1,300 @@
+import path from 'node:path';
+import { fs, util } from '@appium/support';
+import { asyncmap } from 'asyncbox';
+import * as semver from 'semver';
+import { CHROMEDRIVER_CHROME_MAPPING, getChromedriverBinaryPath, compareVersions } from '../utils.js';
+const NEW_CD_VERSION_FORMAT_MAJOR_VERSION = 73;
+const CD_VERSION_TIMEOUT = 5000;
+const GET_COMPATIBLE_CHROMEDRIVER_MAX_ITERATIONS = 10;
+/**
+ * Loads and normalizes Chromedriver-to-Chrome version mapping.
+ */
+export async function getDriversMapping() {
+    let mapping = structuredClone(CHROMEDRIVER_CHROME_MAPPING);
+    if (this.mappingPath) {
+        this.log.debug(`Attempting to use Chromedriver->Chrome mapping from '${this.mappingPath}'`);
+        if (!(await fs.exists(this.mappingPath))) {
+            this.log.warn(`No file found at '${this.mappingPath}'`);
+            this.log.info('Defaulting to the static Chromedriver->Chrome mapping');
+        }
+        else {
+            try {
+                mapping = JSON.parse(await fs.readFile(this.mappingPath, 'utf8'));
+            }
+            catch (e) {
+                const err = e;
+                this.log.warn(`Error parsing mapping from '${this.mappingPath}': ${err.message}`);
+                this.log.info('Defaulting to the static Chromedriver->Chrome mapping');
+            }
+        }
+    }
+    else {
+        this.log.debug('Using the static Chromedriver->Chrome mapping');
+    }
+    for (const [cdVersion, chromeVersion] of Object.entries(mapping)) {
+        const coercedVersion = semver.coerce(chromeVersion);
+        if (coercedVersion) {
+            mapping[cdVersion] = coercedVersion.version;
+        }
+        else {
+            this.log.info(`'${chromeVersion}' is not a valid version number. Skipping it`);
+        }
+    }
+    return mapping;
+}
+/**
+ * Discovers available Chromedriver binaries and parses their versions.
+ */
+export async function getChromedrivers(mapping) {
+    // enumerate available executables in configured chromedriver directory
+    const executables = await fs.glob('*', {
+        cwd: this.executableDir,
+        nodir: true,
+        absolute: true,
+    });
+    this.log.debug(`Found ${util.pluralize('executable', executables.length, true)} in '${this.executableDir}'`);
+    const cds = (await asyncmap(executables, async (executable) => {
+        const logError = ({ message, stdout, stderr }) => {
+            let errMsg = `Cannot retrieve version number from '${path.basename(executable)}' Chromedriver binary. ` +
+                `Make sure it returns a valid version string in response to '--version' command line argument. ${message}`;
+            if (stdout) {
+                errMsg += `\nStdout: ${stdout}`;
+            }
+            if (stderr) {
+                errMsg += `\nStderr: ${stderr}`;
+            }
+            this.log.warn(errMsg);
+            return null;
+        };
+        let stdout;
+        let stderr;
+        try {
+            ({ stdout, stderr } = await this._execFunc(executable, ['--version'], {
+                timeout: CD_VERSION_TIMEOUT,
+            }));
+        }
+        catch (e) {
+            const err = e;
+            if (!(err.message || '').includes('timed out') && !(err.stdout || '').includes('Starting ChromeDriver')) {
+                return logError(err);
+            }
+            // timeouts may still contain the version banner in stdout
+            stdout = err.stdout;
+        }
+        const match = /ChromeDriver\s+\(?v?([\d.]+)\)?/i.exec(stdout);
+        if (!match) {
+            return logError({ message: 'Cannot parse the version string', stdout, stderr });
+        }
+        let version = match[1];
+        let minChromeVersion = mapping[version] || null;
+        const coercedVersion = semver.coerce(version);
+        if (coercedVersion) {
+            if (coercedVersion.major < NEW_CD_VERSION_FORMAT_MAJOR_VERSION) {
+                version = `${coercedVersion.major}.${coercedVersion.minor}`;
+                minChromeVersion = mapping[version] || null;
+            }
+            if (!minChromeVersion && coercedVersion.major >= NEW_CD_VERSION_FORMAT_MAJOR_VERSION) {
+                minChromeVersion = `${coercedVersion.major}`;
+            }
+        }
+        return { executable, version, minChromeVersion };
+    }))
+        .filter((cd) => !!cd)
+        .sort((a, b) => compareVersions(b.version, a.version));
+    if (cds.length === 0) {
+        this.log.info(`No Chromedrivers were found in '${this.executableDir}'`);
+        return cds;
+    }
+    this.log.debug(`The following Chromedriver executables were found:`);
+    for (const cd of cds) {
+        this.log.debug(`    '${cd.executable}' (version '${cd.version}', minimum Chrome version '${cd.minChromeVersion ? cd.minChromeVersion : 'Unknown'}')`);
+    }
+    return cds;
+}
+/**
+ * Persists updated version mapping to disk or falls back to in-memory update.
+ */
+export async function updateDriversMapping(newMapping) {
+    let shouldUpdateStaticMapping = true;
+    if (!this.mappingPath) {
+        this.log.warn('No mapping path provided');
+        return;
+    }
+    if (await fs.exists(this.mappingPath)) {
+        try {
+            await fs.writeFile(this.mappingPath, JSON.stringify(newMapping, null, 2), 'utf8');
+            shouldUpdateStaticMapping = false;
+        }
+        catch (e) {
+            const err = e;
+            this.log.warn(`Cannot store the updated chromedrivers mapping into '${this.mappingPath}'. ` +
+                `This may reduce the performance of further executions. Original error: ${err.message}`);
+        }
+    }
+    if (shouldUpdateStaticMapping) {
+        Object.assign(CHROMEDRIVER_CHROME_MAPPING, newMapping);
+    }
+}
+/**
+ * Selects the most suitable Chromedriver binary for current environment.
+ */
+export async function getCompatibleChromedriver() {
+    if (usesDesktopChromedriverDefault(this)) {
+        return await getChromedriverBinaryPath();
+    }
+    const ctx = this;
+    const mapping = await ctx.getDriversMapping();
+    if (!util.isEmpty(mapping)) {
+        ctx.log.debug(`The most recent known Chrome version: ${Object.values(mapping)[0]}`);
+    }
+    const syncState = { didStorageSync: false };
+    for (let iteration = 0; iteration < GET_COMPATIBLE_CHROMEDRIVER_MAX_ITERATIONS; iteration++) {
+        const cds = await ctx.getChromedrivers(mapping);
+        await mergeDiscoveredMappingGaps(ctx, cds, mapping);
+        if (ctx.disableBuildCheck) {
+            return pickChromedriverWithBuildCheckDisabled(ctx, cds);
+        }
+        const chromeVersion = await ctx.getChromeVersion();
+        if (!chromeVersion) {
+            return pickChromedriverWhenChromeUnknown(ctx, cds);
+        }
+        ctx.log.debug(`Found Chrome bundle '${ctx.bundleId}' version '${chromeVersion}'`);
+        const matchingDrivers = filterChromedriversMatchingChrome(cds, chromeVersion);
+        if (matchingDrivers.length === 0) {
+            if (ctx.storageClient && !syncState.didStorageSync) {
+                try {
+                    if (await attemptChromedriverStorageSync(ctx, mapping, chromeVersion, syncState)) {
+                        continue;
+                    }
+                }
+                catch (e) {
+                    const err = e;
+                    ctx.log.warn(`Cannot synchronize local chromedrivers with the remote storage: ${err.message}`);
+                    if (err.stack) {
+                        ctx.log.debug(err.stack);
+                    }
+                }
+            }
+            throw makeNoMatchingChromedriverError(ctx, chromeVersion);
+        }
+        return logChosenMatchingChromedriver(ctx, matchingDrivers, chromeVersion);
+    }
+    throw new Error(`Exceeded ${GET_COMPATIBLE_CHROMEDRIVER_MAX_ITERATIONS} iterations while selecting a compatible Chromedriver.`);
+}
+/**
+ * Resolves and verifies the effective Chromedriver executable path.
+ */
+export async function initChromedriverPath() {
+    if (this.executableVerified && this.chromedriver) {
+        return this.chromedriver;
+    }
+    let chromedriver = this.chromedriver;
+    if (!chromedriver) {
+        chromedriver = this.chromedriver = this.useSystemExecutable
+            ? await getChromedriverBinaryPath()
+            : await this.getCompatibleChromedriver();
+    }
+    if (!chromedriver) {
+        throw new Error('Cannot determine a valid Chromedriver executable path');
+    }
+    if (!(await fs.exists(chromedriver))) {
+        throw new Error(`Trying to use a chromedriver binary at the path ${chromedriver}, but it doesn't exist!`);
+    }
+    this.executableVerified = true;
+    this.log.info(`Set chromedriver binary as: ${chromedriver}`);
+    return chromedriver;
+}
+function usesDesktopChromedriverDefault(ctx) {
+    return !ctx.adb && !ctx.isCustomExecutableDir;
+}
+async function mergeDiscoveredMappingGaps(ctx, cds, mapping) {
+    const missingVersions = {};
+    for (const { version, minChromeVersion } of cds) {
+        if (!minChromeVersion || mapping[version]) {
+            continue;
+        }
+        const coercedVer = semver.coerce(version);
+        if (!coercedVer || coercedVer.major < NEW_CD_VERSION_FORMAT_MAJOR_VERSION) {
+            continue;
+        }
+        missingVersions[version] = minChromeVersion;
+    }
+    const missingCount = Object.keys(missingVersions).length;
+    if (missingCount === 0) {
+        return;
+    }
+    ctx.log.info(`Found ${util.pluralize('Chromedriver', missingCount, true)}, ` +
+        `which ${missingCount === 1 ? 'is' : 'are'} missing in the list of known versions: ` +
+        JSON.stringify(missingVersions));
+    await ctx.updateDriversMapping(Object.assign(mapping, missingVersions));
+}
+function pickChromedriverWithBuildCheckDisabled(ctx, cds) {
+    if (cds.length === 0) {
+        throw ctx.log.errorWithException(`There must be at least one Chromedriver executable available for use if ` +
+            `'chromedriverDisableBuildCheck' capability is set to 'true'`);
+    }
+    const { version, executable } = cds[0];
+    ctx.log.warn(`Chrome build check disabled. Using most recent Chromedriver version (${version}, at '${executable}')`);
+    ctx.log.warn(`If this is wrong, set 'chromedriverDisableBuildCheck' capability to 'false'`);
+    return executable;
+}
+function pickChromedriverWhenChromeUnknown(ctx, cds) {
+    if (cds.length === 0) {
+        throw ctx.log.errorWithException(`There must be at least one Chromedriver executable available for use if ` +
+            `the current Chrome version cannot be determined`);
+    }
+    const { version, executable } = cds[0];
+    ctx.log.warn(`Unable to discover Chrome version. Using Chromedriver ${version} at '${executable}'`);
+    return executable;
+}
+function filterChromedriversMatchingChrome(cds, chromeVersion) {
+    return cds.filter(({ minChromeVersion }) => {
+        const minChromeVersionS = minChromeVersion && semver.coerce(minChromeVersion);
+        if (!minChromeVersionS) {
+            return false;
+        }
+        return chromeVersion.major > NEW_CD_VERSION_FORMAT_MAJOR_VERSION
+            ? minChromeVersionS.major === chromeVersion.major
+            : semver.gte(chromeVersion, minChromeVersionS);
+    });
+}
+/**
+ * Syncs drivers from remote storage into `mapping` and persists when possible.
+ * Sets `syncState.didStorageSync` before any early return so a second sync is not attempted.
+ */
+async function attemptChromedriverStorageSync(ctx, mapping, chromeVersion, syncState) {
+    syncState.didStorageSync = true;
+    if (!ctx.storageClient) {
+        return false;
+    }
+    const retrievedMapping = await ctx.storageClient.retrieveMapping();
+    ctx.log.debug('Got chromedrivers mapping from the storage: ' +
+        util.truncateString(JSON.stringify(retrievedMapping, null, 2), { length: 500 }));
+    const driverKeys = await ctx.storageClient.syncDrivers({
+        minBrowserVersion: chromeVersion.major,
+    });
+    if (driverKeys.length === 0) {
+        return false;
+    }
+    const synchronizedDriversMapping = driverKeys.reduce((acc, x) => {
+        const { version, minBrowserVersion } = retrievedMapping[x];
+        acc[version] = minBrowserVersion;
+        return acc;
+    }, {});
+    Object.assign(mapping, synchronizedDriversMapping);
+    await ctx.updateDriversMapping(mapping);
+    return true;
+}
+function makeNoMatchingChromedriverError(ctx, chromeVersion) {
+    const autodownloadSuggestion = 'You could also try to enable automated chromedrivers download as a possible workaround.';
+    return new Error(`No Chromedriver found that can automate Chrome '${chromeVersion}'.` +
+        (ctx.storageClient ? '' : ` ${autodownloadSuggestion}`));
+}
+function logChosenMatchingChromedriver(ctx, matchingDrivers, chromeVersion) {
+    const binPath = matchingDrivers[0].executable;
+    ctx.log.debug(`Found ${util.pluralize('executable', matchingDrivers.length, true)} ` +
+        `capable of automating Chrome '${chromeVersion}'.\nChoosing the most recent, '${binPath}'.`);
+    ctx.log.debug(`If a specific version is required, specify it with the 'chromedriverExecutable' capability.`);
+    return binPath;
+}
+//# sourceMappingURL=binary.js.map