@applitools/eyes-selenium 4.58.1 → 4.58.4

package/CHANGELOG.md

@@ -3,6 +3,34 @@
 ## Unreleased
 
 
+
+## 4.58.4 - 2022/4/14
+
+### Features
+- Support UFG for native mobile
+- `runner.getAllTestResults` returns the corresponding UFG browser/device configuration for each test. This is available as `runner.getAllTestResults()[i].browserInfo`.
+### Bug fixes
+- `extractText` now supports regions that don't use hints while using `x`/`y` coordinates
+- accept ios and android lowercase as driver platformName capability when using custom grid
+- when running on a native iOS app, allow capturing NavigationBar and TabBar regions
+- When running a native app on Android, in case we test a device in landscape mode, make sure to account for the navigation bar on the left or right and not at the bottom of the image. Also account for an Appium bug when calculating system bars height.
+- Support data urls in iframes
+
+## 4.58.3 - 2022/1/12
+
+- fix bugs
+- updated to @applitools/eyes-sdk-core@12.24.12 (from 12.24.3)
+- updated to @applitools/spec-driver-selenium@1.3.1 (from 1.3.0)
+- updated to @applitools/visual-grid-client@15.8.59 (from 15.8.47)
+- updated to @applitools/spec-driver-selenium@1.3.2 (from 1.3.1)
+- updated to @applitools/eyes-sdk-core@12.24.13 (from 12.24.12)
+- updated to @applitools/spec-driver-selenium@1.3.3 (from 1.3.2)
+- updated to @applitools/visual-grid-client@15.8.60 (from 15.8.59)
+
+## 4.58.2 - 2021/11/18
+
+- updated to @applitools/eyes-sdk-core@12.24.3 (from 12.24.2)
+
 ## 4.58.1 - 2021/11/18
 
 - updated to @applitools/eyes-sdk-core@12.24.2 (from 12.24.0)

package/README.md

@@ -36,6 +36,7 @@
   * [Purpose of runners](#purpose-of-runners)
     + [1. Use the Ultrafast grid](#1-use-the-ultra-fast-grid)
     + [2. Manage tests across multiple `Eyes` instances](#2-manage-tests-across-multiple-eyes-instances)
+- [Visual locators](#visual-locators)
 - [Recipes for common tasks](#recipes-for-common-tasks)
   * [Configure Server URL](#configure-server-url)
   * [Configure Proxy](#configure-proxy)
@@ -536,6 +537,62 @@ concurrent sessions ???
 add browsers
 -->
 
+## Visual locators
+
+Information about what are visual locators and how to use them can be found in the documentation page [here](https://applitools.com/docs/features/visual-locators.html).
+
+The API to locate a visual locator in Eyes-Selenium has the following TypeScript signature:
+
+```ts
+// Note: This is a formal TypeScript definition.
+// The reason we use the generic type TLocator here is that is shows how the return value of eyes.locate is an object
+// with the same keys as the array of locatorNames in the input to eyes.locate.
+// We explain this in more detail in the example below.
+
+interface Eyes {
+  locate<TLocator extends string>(settings: VisualLocatorSettings<TLocator>): Promise<Record<TLocator, Array<Region>>>
+}
+
+interface VisualLocatorSettings<TLocator extends string> {
+  locatorNames: Array<TLocator>;
+  firstOnly: boolean;
+}
+
+interface Region {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+```
+
+Here is an example for using this API:
+
+```js
+// first need to call eyes.open
+await eyes.open(driver, 'Test app', 'Test visual locators')
+
+// example for using eyes.locate
+const regionsMap = await eyes.locate({
+  locatorNames: ['locator_a', 'locator_b', 'locator_c'],
+})
+
+// now get the coordinates of one of the locators
+const regionsForLocator_A = regionsMap['locator_a']
+
+// if region is found, perform press at the middle
+if (regionsForLocator_A && regionsForLocator_A.length > 0) {
+  const region = regionsForLocator_A[0]
+  const clickLocation = {
+    x: region.left + region.width / 2,
+    y: region.top + region.height / 2,
+  }
+  await driver.actions({ bridge: true }).move(clickLocation).click().perform()
+}
+```
+
+### 
+
 ## Recipes for common tasks
 
 ### Configure Server URL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/eyes-selenium",
-  "version": "4.58.1",
+  "version": "4.58.4",
   "description": "Applitools Eyes SDK for Selenium WebDriver",
   "keywords": [
     "eyes-selenium",
@@ -45,18 +45,19 @@
   "scripts": {
     "lint": "eslint '**/*.ts'",
     "build": "ttsc",
-    "generate:tests": "coverage-tests generate https://raw.githubusercontent.com/applitools/sdk.coverage.tests/master/js/config.js --name 'eyes-selenium'",
+    "generate:tests": "coverage-tests generate https://raw.githubusercontent.com/applitools/sdk.coverage.tests/universal-sdk/js/config.js --name 'eyes-selenium'",
     "test": "yarn test:coverage",
     "test:coverage": "yarn generate:tests && APPLITOOLS_BATCH_NAME='JS Coverage Tests: eyes-selenium' APPLITOOLS_BATCH_ID=$(uuidgen) XUNIT_FILE=coverage-test-report.xml mocha --config .mocharc.cvg.js",
     "report": "coverage-tests report https://raw.githubusercontent.com/applitools/sdk.coverage.tests/master/js/config.js --name 'eyes-selenium'",
     "setup": "yarn docker:setup",
     "docker:setup": "node ../scripts/scripts/generate-docker-compose-config.js && docker-compose up -d",
     "docker:teardown": "docker-compose down",
+    "upgrade:framework": "if [ ! -z $APPLITOOLS_SELENIUM_MAJOR_VERSION ]; then packagejson=`cat package.json`; yarn upgrade --no-lockfile selenium-webdriver@$APPLITOOLS_SELENIUM_MAJOR_VERSION; echo \"$packagejson\" > package.json; fi",
     "deps": "bongo deps",
     "gh:test": "gh workflow run test.yml --ref $(git rev-parse --abbrev-ref HEAD) -f packages='selenium selenium@3' -f links='types test-utils sdk-shared eyes-sdk-core visual-grid-client eyes-api spec-driver-selenium utils driver snippets screenshoter' -f linking-depth=3",
-    "gh:publish": "gh workflow run publish.yml --ref $(git rev-parse --abbrev-ref HEAD) -f packages='selenium'",
-    "preversion": "bongo preversion && yarn build",
-    "version": "bongo version",
+    "gh:publish": "gh workflow run publish-selenium.yml --ref $(git rev-parse --abbrev-ref HEAD)",
+    "preversion": "bongo preversion --verifyPendingChanges && yarn build",
+    "version": "bongo version --withPendingChanges",
     "postversion": "bongo postversion"
   },
   "husky": {
@@ -65,18 +66,18 @@
     }
   },
   "dependencies": {
-    "@applitools/eyes-api": "1.1.6",
-    "@applitools/eyes-sdk-core": "12.24.2",
-    "@applitools/spec-driver-selenium": "1.3.0",
-    "@applitools/visual-grid-client": "15.8.47"
+    "@applitools/eyes-api": "1.2.0",
+    "@applitools/eyes-sdk-core": "13.2.6",
+    "@applitools/spec-driver-selenium": "1.3.5",
+    "@applitools/visual-grid-client": "15.11.3"
   },
   "devDependencies": {
-    "@applitools/api-extractor": "1.2.3",
-    "@applitools/scripts": "1.0.1",
-    "@applitools/sdk-coverage-tests": "2.3.16",
-    "@applitools/sdk-release-kit": "0.13.4",
-    "@applitools/sdk-shared": "0.9.9",
-    "@applitools/test-utils": "1.0.9",
+    "@applitools/api-extractor": "1.2.7",
+    "@applitools/bongo": "^2.0.2",
+    "@applitools/scripts": "1.1.0",
+    "@applitools/sdk-coverage-tests": "2.3.18",
+    "@applitools/sdk-shared": "0.9.11",
+    "@applitools/test-utils": "1.3.0",
     "@types/selenium-webdriver": "^4.0.11",
     "@typescript-eslint/eslint-plugin": "^4.15.1",
     "@typescript-eslint/parser": "^4.15.1",
@@ -89,10 +90,10 @@
     "husky": "^4.3.8",
     "mocha": "^9.1.2",
     "prettier": "^2.1.2",
-    "selenium-webdriver": "^4.0.0",
+    "selenium-webdriver": "^4.1.1",
     "spec-xunit-file": "0.0.1-3",
     "ttypescript": "^1.5.12",
-    "typescript": "^4.5.1-rc"
+    "typescript": "^4.5.4"
   },
   "peerDependencies": {
     "selenium-webdriver": ">=3.6.0"

package/types/index.d.ts

@@ -142,6 +142,7 @@ export type ConfigurationPlain = {
     apiKey?: string;
     serverUrl?: string;
     proxy?: ProxySettingsPlain;
+    autProxy?: { proxy: { url: string; username?: string; password?: string; isHttpOnly?: boolean; }; domains?: Array<string>; AUTProxyMode?: "Allow" | "Block"; };
     isDisabled?: boolean;
     connectionTimeout?: number;
     removeSession?: boolean;
@@ -166,6 +167,7 @@ export type ConfigurationPlain = {
     baselineBranchName?: string;
     compareWithParentBranch?: boolean;
     ignoreBaseline?: boolean;
+    ignoreGitMergeBase?: boolean;
     saveFailedTests?: boolean;
     saveNewTests?: boolean;
     saveDiffs?: boolean;
@@ -251,6 +253,10 @@ export class Configuration implements Required<ConfigurationPlain> {
     setProxy(proxy: ProxySettingsPlain): Configuration;
     setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): Configuration;
     setProxy(isEnabled: false): Configuration;
+    get autProxy(): { proxy: { url: string; username?: string; password?: string; isHttpOnly?: boolean; }; domains?: Array<string>; AUTProxyMode?: "Allow" | "Block"; };
+    set autProxy(autProxy: { proxy: { url: string; username?: string; password?: string; isHttpOnly?: boolean; }; domains?: Array<string>; AUTProxyMode?: "Allow" | "Block"; });
+    getAutProxy(): { proxy: { url: string; username?: string; password?: string; isHttpOnly?: boolean; }; domains?: Array<string>; AUTProxyMode?: "Allow" | "Block"; };
+    setAutProxy(autProxy: { proxy: { url: string; username?: string; password?: string; isHttpOnly?: boolean; }; domains?: Array<string>; AUTProxyMode?: "Allow" | "Block"; }): Configuration;
     get connectionTimeout(): number;
     set connectionTimeout(connectionTimeout: number);
     getConnectionTimeout(): number;
@@ -298,6 +304,10 @@ export class Configuration implements Required<ConfigurationPlain> {
     set compareWithParentBranch(compareWithParentBranch: boolean);
     getCompareWithParentBranch(): boolean;
     setCompareWithParentBranch(compareWithParentBranch: boolean): Configuration;
+    get ignoreGitMergeBase(): boolean;
+    set ignoreGitMergeBase(ignoreGitMergeBase: boolean);
+    getIgnoreGitMergeBase(): boolean;
+    setIgnoreGitMergeBase(ignoreGitMergeBase: boolean): Configuration;
     get ignoreBaseline(): boolean;
     set ignoreBaseline(ignoreBaseline: boolean);
     getIgnoreBaseline(): boolean;
@@ -458,6 +468,7 @@ export type CheckSettingsPlain = {
     visualGridOptions?: { [key: string]: any; };
     hooks?: { beforeCaptureScreenshot: string; };
     renderId?: string;
+    pageId?: string;
     variationGroupId?: string;
     timeout?: number;
     waitBeforeCapture?: number;
@@ -537,6 +548,7 @@ export class CheckSettings {
     visualGridOption(key: string, value: any): CheckSettings;
     visualGridOptions(options: { [key: string]: any; }): CheckSettings;
     renderId(renderId: string): CheckSettings;
+    pageId(pageId: string): CheckSettings;
     variationGroupId(variationGroupId: string): CheckSettings;
     timeout(timeout: number): CheckSettings;
     waitBeforeCapture(waitBeforeCapture: number): CheckSettings;
@@ -606,7 +618,7 @@ export enum CorsIframeHandle {
     KEEP = 'KEEP',
     SNAPSHOT = 'SNAPSHOT'
 }
-export type DeviceNamePlain = "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5";
+export type DeviceNamePlain = "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "Galaxy Tab S7" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5";
 export enum DeviceName {
     Blackberry_PlayBook = 'Blackberry PlayBook',
     BlackBerry_Z30 = 'BlackBerry Z30',
@@ -627,6 +639,7 @@ export enum DeviceName {
     Galaxy_S10 = 'Galaxy S10',
     Galaxy_S10_Plus = 'Galaxy S10 Plus',
     Galaxy_S20 = 'Galaxy S20',
+    Galaxy_Tab_S7 = 'Galaxy Tab S7',
     iPad = 'iPad',
     iPad_6th_Gen = 'iPad 6th Gen',
     iPad_7th_Gen = 'iPad 7th Gen',
@@ -676,7 +689,7 @@ export enum FailureReport {
     IMMEDIATE = 'IMMEDIATE',
     ON_CLOSE = 'ON_CLOSE'
 }
-export type IosDeviceNamePlain = "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)";
+export type IosDeviceNamePlain = "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)" | "iPad Air (4th generation)";
 export enum IosDeviceName {
     iPhone_13_Pro_Max = 'iPhone 13 Pro Max',
     iPhone_13_Pro = 'iPhone 13 Pro',
@@ -696,7 +709,8 @@ export enum IosDeviceName {
     iPad_Pro_3 = 'iPad Pro (12.9-inch) (3rd generation)',
     iPad_7 = 'iPad (7th generation)',
     iPad_9 = 'iPad (9th generation)',
-    iPad_Air_2 = 'iPad Air (2nd generation)'
+    iPad_Air_2 = 'iPad Air (2nd generation)',
+    iPad_Air_4 = 'iPad Air (4th generation)'
 }
 export type IosVersionPlain = "latest" | "latest-1";
 export enum IosVersion {
@@ -810,7 +824,8 @@ export class BatchInfo implements Required<BatchInfoPlain> {
     set properties(properties: Array<PropertyDataPlain>);
     getProperties(): Array<PropertyData>;
     setProperties(properties: Array<PropertyDataPlain>): BatchInfo;
-    addProperty(property: PropertyDataPlain): BatchInfo;
+    addProperty(name: string, value: string): BatchInfo;
+    addProperty(prop: PropertyDataPlain): BatchInfo;
 }
 export type CutProviderPlain = { top: number; right: number; bottom: number; left: number; } | { x: number; y: number; width: number; height: number; };
 export class CutProvider implements Required<{
@@ -1335,15 +1350,71 @@ export class TestResults implements Required<TestResultsPlain> {
     delete(): Promise<void>;
     deleteSession(): Promise<void>;
 }
-export type TestResultContainerPlain = { readonly exception: Error; readonly testResults: TestResultsPlain; };
+export type TestResultContainerPlain = { readonly exception?: Error; readonly testResults?: {
+    readonly id?: string;
+    readonly name?: string;
+    readonly secretToken?: string;
+    readonly status?: "Passed" | "Failed" | "Unresolved";
+    readonly appName?: string;
+    readonly batchId?: string;
+    readonly batchName?: string;
+    readonly branchName?: string;
+    readonly hostOS?: string;
+    readonly hostApp?: string;
+    readonly hostDisplaySize?: { width: number; height: number; };
+    readonly accessibilityStatus?: { readonly level: "AA" | "AAA"; readonly version: "WCAG_2_0" | "WCAG_2_1"; readonly status: "Passed" | "Failed"; };
+    readonly startedAt?: string | Date;
+    readonly duration?: number;
+    readonly isNew?: boolean;
+    readonly isDifferent?: boolean;
+    readonly isAborted?: boolean;
+    readonly appUrls?: { readonly batch?: string; readonly session?: string; };
+    readonly apiUrls?: { readonly batch?: string; readonly session?: string; };
+    readonly stepsInfo?: Array<{
+        readonly name?: string;
+        readonly isDifferent?: boolean;
+        readonly hasBaselineImage?: boolean;
+        readonly hasCurrentImage?: boolean;
+        readonly appUrls?: { readonly step?: string; readonly stepEditor?: string; };
+        readonly apiUrls?: {
+            readonly baselineImage?: string;
+            readonly currentImage?: string;
+            readonly checkpointImage?: string;
+            readonly checkpointImageThumbnail?: string;
+            readonly diffImage?: string;
+        };
+        readonly renderId?: Array<string>;
+    }>;
+    readonly steps?: number;
+    readonly matches?: number;
+    readonly mismatches?: number;
+    readonly missing?: number;
+    readonly exactMatches?: number;
+    readonly strictMatches?: number;
+    readonly contentMatches?: number;
+    readonly layoutMatches?: number;
+    readonly noneMatches?: number;
+    readonly url?: string;
+}; readonly browserInfo?: { name?: "chrome" | "chrome-one-version-back" | "chrome-two-versions-back" | "firefox" | "firefox-one-version-back" | "firefox-two-versions-back" | "ie" | "ie10" | "edge" | "edgechromium" | "edgelegacy" | "edgechromium-one-version-back" | "edgechromium-two-versions-back" | "safari" | "safari-earlyaccess" | "safari-one-version-back" | "safari-two-versions-back"; width: number; height: number; } | { chromeEmulationInfo: { deviceName: "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "Galaxy Tab S7" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5"; screenOrientation?: "portrait" | "landscape"; }; } | { iosDeviceInfo: { deviceName: "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)" | "iPad Air (4th generation)"; iosVersion?: "latest" | "latest-1"; screenOrientation?: "portrait" | "landscape"; }; }; };
 export class TestResultContainer implements Required<TestResultContainerPlain> {
     get testResults(): TestResultsPlain;
     getTestResults(): TestResults;
     get exception(): Error;
     getException(): Error;
+    get browserInfo(): { name?: "chrome" | "chrome-one-version-back" | "chrome-two-versions-back" | "firefox" | "firefox-one-version-back" | "firefox-two-versions-back" | "ie" | "ie10" | "edge" | "edgechromium" | "edgelegacy" | "edgechromium-one-version-back" | "edgechromium-two-versions-back" | "safari" | "safari-earlyaccess" | "safari-one-version-back" | "safari-two-versions-back"; width: number; height: number; } | { chromeEmulationInfo: { deviceName: "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "Galaxy Tab S7" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5"; screenOrientation?: "portrait" | "landscape"; }; } | { iosDeviceInfo: { deviceName: "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)" | "iPad Air (4th generation)"; iosVersion?: "latest" | "latest-1"; screenOrientation?: "portrait" | "landscape"; }; };
+    getBrowserInfo(): { name?: "chrome" | "chrome-one-version-back" | "chrome-two-versions-back" | "firefox" | "firefox-one-version-back" | "firefox-two-versions-back" | "ie" | "ie10" | "edge" | "edgechromium" | "edgelegacy" | "edgechromium-one-version-back" | "edgechromium-two-versions-back" | "safari" | "safari-earlyaccess" | "safari-one-version-back" | "safari-two-versions-back"; width: number; height: number; } | { chromeEmulationInfo: { deviceName: "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "Galaxy Tab S7" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5"; screenOrientation?: "portrait" | "landscape"; }; } | { iosDeviceInfo: { deviceName: "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)" | "iPad Air (4th generation)"; iosVersion?: "latest" | "latest-1"; screenOrientation?: "portrait" | "landscape"; }; };
 }
-export type TestResultsSummaryPlain = Iterable<TestResultContainerPlain>;
-export class TestResultsSummary implements TestResultsSummaryPlain {
+export type TestResultsSummaryPlain = {
+    results: Array<TestResultContainerPlain>;
+    passed: number;
+    unresolved: number;
+    failed: number;
+    exceptions: number;
+    mismatches: number;
+    missing: number;
+    matches: number;
+};
+export class TestResultsSummary implements Iterable<TestResultContainerPlain> {
     getAllResults(): Array<TestResultContainer>;
     [Symbol.iterator](): Iterator<TestResultContainer, any, undefined>;
 }
@@ -1379,7 +1450,42 @@ export class Logger {
     fatal(...messages: Array<any>): void;
     open(): void;
     close(): void;
-    extend(label?: string, color?: string | Array<string>): Logger;
+    extend(options?: Omit<{
+        handler?: CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain | {
+            type: "rolling file";
+            dirname?: string;
+            name?: string;
+            maxFileLength?: number;
+            maxFileNumber?: number;
+        };
+        format?: (message: any, options: {
+            formatting?: boolean;
+            label?: string;
+            timestamp?: Date;
+            level?: "silent" | "fatal" | "error" | "warn" | "info";
+            tags?: Record<string, unknown>;
+            color?: string | Array<string>;
+            colors?: { timestamp?: string | Array<string>; level?: {
+                silent?: string | Array<string>;
+                fatal?: string | Array<string>;
+                error?: string | Array<string>;
+                warn?: string | Array<string>;
+                info?: string | Array<string>;
+            }; tags?: string | Array<string>; message?: string | Array<string>; };
+        }) => string;
+        label?: string;
+        timestamp?: false;
+        level?: number | ("silent" | "fatal" | "error" | "warn" | "info");
+        colors?: boolean | { timestamp?: string | Array<string>; level?: {
+            silent?: string | Array<string>;
+            fatal?: string | Array<string>;
+            error?: string | Array<string>;
+            warn?: string | Array<string>;
+            info?: string | Array<string>;
+        }; tags?: string | Array<string>; message?: string | Array<string>; };
+        console?: boolean | CustomLogHandlerPlain;
+    }, "handler">): Logger;
+    extend(label?: string): Logger;
 }
 export function closeBatch(spec: { closeBatches(options: { settings: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }; }): Promise<void>; }): (options: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }) => Promise<void>;
 export abstract class EyesRunner {