@cloudscape-design/browser-test-tools 3.0.0

package/dist/browsers/browserstack.js

@@ -0,0 +1,138 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const url_1 = require("url");
+const p_retry_1 = __importStar(require("p-retry"));
+const browser_creator_1 = __importDefault(require("./browser-creator"));
+const exceptions_1 = require("../exceptions");
+const capabilities_1 = require("./capabilities");
+const N_SEC_SLEEP_BEFORE_RETRY = 30;
+const browserStackHub = 'http://hub.browserstack.com:80/wd/hub';
+const browsers = {
+    Firefox: {
+        browserName: 'firefox',
+        // Leave blank so we get the latest version. 'beta' is also a valid option
+        // browserVersion: '69.0',
+        'bstack:options': {
+            seleniumVersion: '3.14.0',
+            os: 'Windows',
+            osVersion: '10',
+        },
+    },
+    Chrome: {
+        browserName: 'chrome',
+        // Leave blank so we get the latest version. 'beta' is also a valid option
+        // browserVersion: '75.0',
+        'bstack:options': {
+            seleniumVersion: '3.5.2',
+            os: 'Windows',
+            osVersion: '10',
+        },
+    },
+    Safari: {
+        browserName: 'safari',
+        browserVersion: '15.1',
+        'bstack:options': {
+            seleniumVersion: '3.141.59',
+            os: 'OS X',
+            osVersion: 'Monterey',
+        },
+    },
+    IE11: {
+        browserName: 'internet explorer',
+        browserVersion: '11.0',
+        'bstack:options': {
+            seleniumVersion: '3.141.59',
+            ie: {
+                driver: '3.141.59',
+            },
+            os: 'Windows',
+            osVersion: '8.1',
+        },
+    },
+    IE11Win7: {
+        browserName: 'internet explorer',
+        browserVersion: '11.0',
+        'bstack:options': {
+            seleniumVersion: '3.141.59',
+            ie: {
+                driver: '3.141.59',
+            },
+            os: 'Windows',
+            osVersion: '7',
+        },
+    },
+    Edge: {
+        browserName: 'edge',
+        browserVersion: '18.0',
+        'bstack:options': {
+            seleniumVersion: '3.5.2',
+            os: 'Windows',
+            osVersion: '10',
+        },
+    },
+};
+class BrowserStackBrowserCreator extends browser_creator_1.default {
+    async getBrowser(options) {
+        const nSecSleepBeforeRetry = this.options.nSecSleepBeforeRetry || N_SEC_SLEEP_BEFORE_RETRY;
+        return (0, p_retry_1.default)(async () => {
+            try {
+                const browser = await this.setupBrowser(options);
+                return browser;
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.indexOf(exceptions_1.BrowserStackFullQueueErrorText) > -1) {
+                    throw error;
+                }
+                throw new p_retry_1.AbortError(error);
+            }
+        }, {
+            minTimeout: nSecSleepBeforeRetry * 1000,
+        });
+    }
+    async __getBrowserUrl() {
+        return new url_1.URL(browserStackHub);
+    }
+    __getCapabilities() {
+        const capabilities = (0, capabilities_1.getCapability)(this.browserName, browsers);
+        const browserstackOptions = this.options;
+        return {
+            ...capabilities,
+            'bstack:options': {
+                ...capabilities['bstack:options'],
+                projectName: browserstackOptions.projectName,
+                buildName: browserstackOptions.buildName,
+                userName: browserstackOptions.credentials.user,
+                accessKey: browserstackOptions.credentials.key,
+            },
+        };
+    }
+}
+exports.default = BrowserStackBrowserCreator;

package/dist/browsers/capabilities.d.ts

@@ -0,0 +1,4 @@
+import type { Capabilities } from '@wdio/types';
+declare const defaultCapabilities: Record<string, Capabilities.DesiredCapabilities>;
+export declare function getCapability<T>(browserName: string, capabilities: Record<string, T>): T;
+export default defaultCapabilities;

package/dist/browsers/capabilities.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCapability = void 0;
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const exceptions_1 = require("../exceptions");
+const defaultCapabilities = {
+    Chrome: {
+        browserName: 'chrome',
+    },
+    ChromeHeadless: {
+        browserName: 'chrome',
+        'goog:chromeOptions': {
+            // inspired by https://github.com/alixaxel/chrome-aws-lambda/blob/master/source/index.js#L71-L114
+            args: [
+                '--disable-background-timer-throttling',
+                '--disable-breakpad',
+                '--disable-client-side-phishing-detection',
+                '--disable-cloud-import',
+                '--disable-default-apps',
+                '--disable-dev-shm-usage',
+                '--disable-extensions',
+                '--disable-gesture-typing',
+                '--disable-hang-monitor',
+                '--disable-infobars',
+                '--disable-notifications',
+                '--disable-offer-store-unmasked-wallet-cards',
+                '--disable-offer-upload-credit-cards',
+                '--disable-popup-blocking',
+                '--disable-print-preview',
+                '--disable-prompt-on-repost',
+                '--disable-setuid-sandbox',
+                '--disable-speech-api',
+                '--disable-sync',
+                '--disable-tab-for-desktop-share',
+                '--disable-translate',
+                '--disable-voice-input',
+                '--disable-wake-on-wifi',
+                '--disk-cache-size=33554432',
+                '--enable-async-dns',
+                '--enable-simple-cache-backend',
+                '--enable-tcp-fast-open',
+                '--enable-webgl',
+                '--hide-scrollbars',
+                '--ignore-gpu-blacklist',
+                '--media-cache-size=33554432',
+                '--metrics-recording-only',
+                '--mute-audio',
+                '--no-default-browser-check',
+                '--no-first-run',
+                '--no-pings',
+                '--no-zygote',
+                '--password-store=basic',
+                '--prerender-from-omnibox=disabled',
+                '--no-sandbox',
+                '--disable-gpu',
+                '--headless',
+            ],
+        },
+    },
+    Firefox: {
+        browserName: 'firefox',
+        'moz:firefoxOptions': {
+            prefs: {
+                'fission.webContentIsolationStrategy': 0,
+                'fission.bfcacheInParent': false,
+            },
+        },
+    },
+    Safari: {
+        browserName: 'safari',
+    },
+    IE11: {
+        browserName: 'internet explorer',
+    },
+};
+function getCapability(browserName, capabilities) {
+    if (!(browserName in capabilities)) {
+        throw new exceptions_1.FatalError(`Browser ${browserName} is not supported in this provider`);
+    }
+    return capabilities[browserName];
+}
+exports.getCapability = getCapability;
+exports.default = defaultCapabilities;

package/dist/browsers/devicefarm-mobile.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+import { URL } from 'url';
+import BrowserCreator from './browser-creator';
+import type { Capabilities } from '@wdio/types';
+export default class MobileBrowserCreator extends BrowserCreator {
+    __getBrowserUrl(): Promise<URL>;
+    __getCapabilities(): Capabilities.DesiredCapabilities;
+}

package/dist/browsers/devicefarm-mobile.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const url_1 = require("url");
+const browser_creator_1 = __importDefault(require("./browser-creator"));
+const capabilities_1 = require("./capabilities");
+// The remaining options like browserName, deviceName, etc. will be covered
+// by default capabilities in DeviceFarm and/or the Appium server.
+const mobileBrowsers = {
+    iOS: {
+        'appium:automationName': 'XCUITest',
+        'appium:platformName': 'iOS',
+        'appium:newCommandTimeout': 180,
+    },
+    Android: {
+        'appium:automationName': 'UiAutomator2',
+        'appium:platformName': 'Android',
+        'appium:newCommandTimeout': 180,
+    },
+};
+class MobileBrowserCreator extends browser_creator_1.default {
+    async __getBrowserUrl() {
+        return new url_1.URL(this.options.seleniumUrl);
+    }
+    __getCapabilities() {
+        return (0, capabilities_1.getCapability)(this.browserName, mobileBrowsers);
+    }
+}
+exports.default = MobileBrowserCreator;

package/dist/browsers/devicefarm.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+import { URL } from 'url';
+import { CredentialsOptions } from 'aws-sdk/lib/credentials';
+import BrowserCreator from './browser-creator';
+import type { Capabilities } from '@wdio/types';
+export interface DevicefarmOptions {
+    retryCount?: number;
+    projectArn: string;
+    expiresInSeconds?: number;
+    credentials: CredentialsOptions;
+}
+export default class DevicefarmBrowserCreator extends BrowserCreator {
+    protected __getBrowserUrl(): Promise<URL>;
+    protected __getCapabilities(): Capabilities.DesiredCapabilities;
+}

package/dist/browsers/devicefarm.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const url_1 = require("url");
+const p_retry_1 = __importStar(require("p-retry"));
+const devicefarm_1 = __importDefault(require("aws-sdk/clients/devicefarm"));
+const browser_creator_1 = __importDefault(require("./browser-creator"));
+const capabilities_1 = __importStar(require("./capabilities"));
+const exceptions_1 = require("../exceptions");
+// This uses undocumented options which prevents proper typing
+const capabilities = {
+    ...capabilities_1.default,
+    IE11: {
+        browserName: 'internet explorer',
+    },
+};
+class DevicefarmBrowserCreator extends browser_creator_1.default {
+    async __getBrowserUrl() {
+        const options = this.options;
+        const client = new devicefarm_1.default({ credentials: options.credentials, region: 'us-west-2' });
+        const response = await (0, p_retry_1.default)(async () => {
+            try {
+                const response = await client
+                    .createTestGridUrl({
+                    projectArn: options.projectArn,
+                    expiresInSeconds: options.expiresInSeconds || 300,
+                })
+                    .promise();
+                return response;
+            }
+            catch (error) {
+                if (isAWSError(error) && error.code === 'ThrottlingException') {
+                    // Retries with backoff when throttled
+                    throw error;
+                }
+                throw new p_retry_1.AbortError(error); // Abort on any other error
+            }
+        }, { retries: options.retryCount || 10 });
+        if (!response.url) {
+            throw new exceptions_1.FatalError('Invalid response from devicefarm: ' + JSON.stringify(response));
+        }
+        return new url_1.URL(response.url);
+    }
+    __getCapabilities() {
+        return (0, capabilities_1.getCapability)(this.browserName, capabilities);
+    }
+}
+exports.default = DevicefarmBrowserCreator;
+function isAWSError(obj) {
+    return obj instanceof Error && typeof obj['code'] === 'string';
+}

package/dist/browsers/index.d.ts

@@ -0,0 +1,4 @@
+export { default as browserstack } from './browserstack';
+export { default as devicefarm } from './devicefarm';
+export { default as devicefarmMobile } from './devicefarm-mobile';
+export { default as local } from './local';

package/dist/browsers/index.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.local = exports.devicefarmMobile = exports.devicefarm = exports.browserstack = void 0;
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var browserstack_1 = require("./browserstack");
+Object.defineProperty(exports, "browserstack", { enumerable: true, get: function () { return __importDefault(browserstack_1).default; } });
+var devicefarm_1 = require("./devicefarm");
+Object.defineProperty(exports, "devicefarm", { enumerable: true, get: function () { return __importDefault(devicefarm_1).default; } });
+var devicefarm_mobile_1 = require("./devicefarm-mobile");
+Object.defineProperty(exports, "devicefarmMobile", { enumerable: true, get: function () { return __importDefault(devicefarm_mobile_1).default; } });
+var local_1 = require("./local");
+Object.defineProperty(exports, "local", { enumerable: true, get: function () { return __importDefault(local_1).default; } });

package/dist/browsers/local.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+import { URL } from 'url';
+import BrowserCreator from './browser-creator';
+import type { Capabilities } from '@wdio/types';
+export default class LocalBrowserCreator extends BrowserCreator {
+    __getBrowserUrl(): Promise<URL>;
+    __getCapabilities(): Capabilities.DesiredCapabilities;
+}

package/dist/browsers/local.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const url_1 = require("url");
+const browser_creator_1 = __importDefault(require("./browser-creator"));
+const capabilities_1 = __importStar(require("./capabilities"));
+const localBrowsers = {
+    ...capabilities_1.default,
+    Chrome: {
+        ...capabilities_1.default.Chrome,
+    },
+    ChromeHeadless: {
+        ...capabilities_1.default.ChromeHeadless,
+        'goog:chromeOptions': {
+            ...capabilities_1.default.ChromeHeadless['goog:chromeOptions'],
+            // do not use retina screen when testing locally
+            mobileEmulation: {
+                deviceMetrics: {
+                    pixelRatio: 1,
+                },
+            },
+        },
+    },
+    ChromeHeadlessIntegration: {
+        ...capabilities_1.default.ChromeHeadless,
+        'goog:chromeOptions': {
+            ...capabilities_1.default.ChromeHeadless['goog:chromeOptions'],
+            args: [
+                '--force-prefers-reduced-motion',
+                ...((_b = (_a = capabilities_1.default.ChromeHeadless['goog:chromeOptions']) === null || _a === void 0 ? void 0 : _a.args) !== null && _b !== void 0 ? _b : []),
+            ],
+        },
+    },
+    Firefox: {
+        ...capabilities_1.default.Firefox,
+        // https://firefox-source-docs.mozilla.org/testing/geckodriver/Capabilities.html
+        'moz:debuggerAddress': true,
+    }, // https://github.com/webdriverio/webdriverio/pull/8355
+};
+class LocalBrowserCreator extends browser_creator_1.default {
+    async __getBrowserUrl() {
+        return new url_1.URL(this.options.seleniumUrl);
+    }
+    __getCapabilities() {
+        return (0, capabilities_1.getCapability)(this.browserName, localBrowsers);
+    }
+}
+exports.default = LocalBrowserCreator;

package/dist/chrome-launcher.d.ts

@@ -0,0 +1,2 @@
+export declare function shutdownWebdriver(): void;
+export declare function startWebdriver(port?: string): Promise<void>;

package/dist/chrome-launcher.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWebdriver = exports.shutdownWebdriver = void 0;
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const child_process_1 = require("child_process");
+const exceptions_1 = require("./exceptions");
+const readline_1 = __importDefault(require("readline"));
+function spawnChromeDriver(port) {
+    const params = [`--port=${port}`, '--log-level=SEVERE', '--path=/'];
+    try {
+        (0, child_process_1.execSync)('hash chromedriver');
+    }
+    catch {
+        throw new exceptions_1.FatalError("Cannot find local chromedriver. Did you run 'npm i -g chromedriver'?");
+    }
+    return (0, child_process_1.spawn)('chromedriver', params);
+}
+let webdriverProcess;
+function shutdownWebdriver() {
+    if (webdriverProcess) {
+        webdriverProcess.kill();
+        webdriverProcess = undefined;
+    }
+}
+exports.shutdownWebdriver = shutdownWebdriver;
+function startWebdriver(port = '9515') {
+    return new Promise((resolve, reject) => {
+        webdriverProcess = spawnChromeDriver(port);
+        webdriverProcess.on('error', error => {
+            shutdownWebdriver();
+            reject(error);
+        });
+        webdriverProcess.on('exit', () => {
+            shutdownWebdriver();
+            reject(new Error('Webdriver process exited too early'));
+        });
+        webdriverProcess.stdout.once('data', () => resolve());
+        const errorReader = readline_1.default.createInterface({ input: webdriverProcess.stderr });
+        errorReader.on('line', (line) => {
+            // chromeDriver spams to the error stream on macOS
+            // https://bugs.chromium.org/p/chromedriver/issues/detail?id=2909
+            if (line.indexOf('Please call TIS/TSM in main thread!!!') === -1) {
+                console.error(line);
+            }
+        });
+    });
+}
+exports.startWebdriver = startWebdriver;

package/dist/exceptions.d.ts

@@ -0,0 +1,17 @@
+declare class CustomError extends Error {
+    constructor(message: string, error?: Error);
+}
+export declare class ScreenshotTakeError extends CustomError {
+}
+export declare class BrowserError extends CustomError {
+}
+export declare class FatalError extends CustomError {
+}
+export declare class FileHandlingError extends FatalError {
+}
+export declare class DiagnosticsError extends FatalError {
+}
+export declare const BrowserStackFullQueueErrorText = "All parallel tests are currently in use, including the queued tests. Please wait to finish or upgrade your plan to add more sessions.";
+export declare const WebdriverIoUnsupportedPuppeteerErrorText = "Using DevTools capabilities is not supported for this session.";
+export declare const WebdriverIoRemotePuppeteerErrorText = "Could't find remote debug port in Firefox options";
+export {};

package/dist/exceptions.js

@@ -0,0 +1,48 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIoRemotePuppeteerErrorText = exports.WebdriverIoUnsupportedPuppeteerErrorText = exports.BrowserStackFullQueueErrorText = exports.DiagnosticsError = exports.FileHandlingError = exports.FatalError = exports.BrowserError = exports.ScreenshotTakeError = void 0;
+// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error#ES6_Custom_Error_Class
+class CustomError extends Error {
+    constructor(message, error) {
+        super(message);
+        this.name = this.constructor.name;
+        if (typeof Error.captureStackTrace === 'function') {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        if (error) {
+            this.stack = (this.stack || '') + error.stack;
+            this.message += `: ${error.message}`;
+        }
+    }
+}
+// Can originate from issues that arise during screenshot taking, does
+// not cover test failures, we use assertions for that.
+// Requires retry
+class ScreenshotTakeError extends CustomError {
+}
+exports.ScreenshotTakeError = ScreenshotTakeError;
+// Used for rethrowing browser exceptions
+// Requires retry
+class BrowserError extends CustomError {
+}
+exports.BrowserError = BrowserError;
+// A family of errors that will not cause test runner to retry a failed test
+class FatalError extends CustomError {
+}
+exports.FatalError = FatalError;
+// Can originate from generic file handling and image processing
+// Does not require retry
+class FileHandlingError extends FatalError {
+}
+exports.FileHandlingError = FileHandlingError;
+// Used for managing control flow, developer experience and diagnostics
+// Does not require retry
+class DiagnosticsError extends FatalError {
+}
+exports.DiagnosticsError = DiagnosticsError;
+exports.BrowserStackFullQueueErrorText = 'All parallel tests are currently in use, including the queued tests. Please wait to finish or upgrade your plan to add more sessions.';
+// https://github.com/webdriverio/webdriverio/blob/f9eae7a6747b4bf55975a891f25643bba2165936/packages/webdriverio/src/commands/browser/getPuppeteer.ts#L123
+exports.WebdriverIoUnsupportedPuppeteerErrorText = 'Using DevTools capabilities is not supported for this session.';
+exports.WebdriverIoRemotePuppeteerErrorText = "Could't find remote debug port in Firefox options";

package/dist/image-utils/compare.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+import { ScreenshotWithOffset } from '../page-objects/types';
+export interface CropAndCompareResult {
+    firstImage: Buffer;
+    secondImage: Buffer;
+    diffImage: Buffer | null;
+    isEqual: boolean;
+    diffPixels: number;
+}
+export declare function cropAndCompare(firstScreenshot: ScreenshotWithOffset, secondScreenshot: ScreenshotWithOffset): Promise<CropAndCompareResult>;