@applitools/driver 1.11.25 → 1.11.27

package/dist/driver.js

@@ -31,15 +31,15 @@ const helper_android_1 = require("./helper-android");
 const user_agent_1 = require("./user-agent");
 const user_agent_data_1 = require("./user-agent-data");
 const capabilities_1 = require("./capabilities");
-const snippets = __importStar(require("@applitools/snippets"));
-const utils = __importStar(require("@applitools/utils"));
 const specUtils = __importStar(require("./spec-utils"));
+const utils = __importStar(require("@applitools/utils"));
+const snippets = require('@applitools/snippets');
 // eslint-disable-next-line
 class Driver {
     constructor(options) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-        if (options.driver instanceof Driver)
-            return options.driver;
+        this._driverInfo = {};
+        this._customConfig = {};
         this._customConfig = (_a = options.customConfig) !== null && _a !== void 0 ? _a : {};
         this._spec = options.spec;
         this._logger = (_c = (_b = options.logger) === null || _b === void 0 ? void 0 : _b.extend({ label: 'driver' })) !== null && _c !== void 0 ? _c : (0, logger_1.makeLogger)({ label: 'driver' });
@@ -135,50 +135,52 @@ class Driver {
     }
     get isIOS() {
         var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isIOS) !== null && _b !== void 0 ? _b : /iOS/i.test(this.platformName);
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isIOS) !== null && _b !== void 0 ? _b : (!!this.platformName && /iOS/i.test(this.platformName));
     }
     get isAndroid() {
         var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isAndroid) !== null && _b !== void 0 ? _b : /Android/i.test(this.platformName);
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isAndroid) !== null && _b !== void 0 ? _b : (!!this.platformName && /Android/i.test(this.platformName));
     }
     get isMac() {
         var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isMac) !== null && _b !== void 0 ? _b : /mac\s?OS/i.test(this.platformName);
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isMac) !== null && _b !== void 0 ? _b : (!!this.platformName && /mac\s?OS/i.test(this.platformName));
     }
     get isWindows() {
         var _a, _b;
-        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isWindows) !== null && _b !== void 0 ? _b : /Windows/i.test(this.platformName);
+        return (_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isWindows) !== null && _b !== void 0 ? _b : (!!this.platformName && /Windows/i.test(this.platformName));
     }
     get isChromium() {
         var _a, _b;
-        return ((_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isChromium) !== null && _b !== void 0 ? _b : (/(chrome)/i.test(this.browserName) || (/edge/i.test(this.browserName) && Number(this.browserVersion) > 44)));
+        return ((_b = (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isChromium) !== null && _b !== void 0 ? _b : (!!this.browserName &&
+            (/(chrome)/i.test(this.browserName) || (/edge/i.test(this.browserName) && Number(this.browserVersion) > 44))));
     }
     get isIE() {
-        return /(internet explorer|ie)/i.test(this.browserName);
+        return !!this.browserName && /(internet explorer|ie)/i.test(this.browserName);
     }
     get isEdgeLegacy() {
-        return /edge/i.test(this.browserName) && Number(this.browserVersion) <= 44;
+        return !!this.browserName && /edge/i.test(this.browserName) && Number(this.browserVersion) <= 44;
+    }
+    get isECClient() {
+        var _a;
+        return !!((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isECClient);
+    }
+    get isEC() {
+        return this.isECClient || (!!this.remoteHostname && /exec-wus.applitools.com/.test(this.remoteHostname));
     }
     get sessionId() {
         var _a;
         return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.sessionId;
     }
-    get isExecutionGridClient() {
+    get remoteHostname() {
         var _a;
-        return !!((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.isExecutionGridClient);
-    }
-    get isExecutionGrid() {
-        var _a, _b;
-        if (this.isExecutionGridClient)
-            return true;
-        return /exec-wus.applitools.com/.test((_b = (_a = this._spec) === null || _a === void 0 ? void 0 : _a.extractHostName) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
+        return (_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.remoteHostname;
     }
     updateCurrentContext(context) {
         this._currentContext = context;
     }
     async init() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18;
-        var _19, _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32, _33, _34;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22;
+        var _23, _24, _25, _26, _27, _28, _29, _30, _31, _32, _33, _34, _35, _36, _37, _38, _39;
         // NOTE: this is here because saucelabs does not provide right capabilities for the first call
         await ((_b = (_a = this._spec).getCapabilities) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
         const capabilities = await ((_d = (_c = this._spec).getCapabilities) === null || _d === void 0 ? void 0 : _d.call(_c, this.target));
@@ -186,26 +188,27 @@ class Driver {
         const capabilitiesInfo = capabilities ? (0, capabilities_1.parseCapabilities)(capabilities) : undefined;
         const driverInfo = await ((_f = (_e = this._spec).getDriverInfo) === null || _f === void 0 ? void 0 : _f.call(_e, this.target));
         this._driverInfo = { ...capabilitiesInfo, ...driverInfo };
+        (_g = (_23 = this._driverInfo).remoteHostname) !== null && _g !== void 0 ? _g : (_23.remoteHostname = (_k = (_j = (_h = this._spec).extractHostName) === null || _j === void 0 ? void 0 : _j.call(_h, this.target)) !== null && _k !== void 0 ? _k : undefined);
         if (this.isMobile) {
             this._driverInfo.orientation =
-                (_g = (await this.getOrientation().catch(() => undefined))) !== null && _g !== void 0 ? _g : this._driverInfo.orientation;
+                (_l = (await this.getOrientation().catch(() => undefined))) !== null && _l !== void 0 ? _l : this._driverInfo.orientation;
             const world = await this.getCurrentWorld();
             this._driverInfo.isWebView = !!(world === null || world === void 0 ? void 0 : world.isWebView);
         }
         if (this.isWeb) {
             const browserInfo = await this.currentContext.executePoll(snippets.getBrowserInfo);
-            (_h = (_19 = this._driverInfo).userAgent) !== null && _h !== void 0 ? _h : (_19.userAgent = browserInfo.userAgent);
-            (_j = (_20 = this._driverInfo).pixelRatio) !== null && _j !== void 0 ? _j : (_20.pixelRatio = browserInfo.pixelRatio);
-            (_k = (_21 = this._driverInfo).viewportScale) !== null && _k !== void 0 ? _k : (_21.viewportScale = browserInfo.viewportScale);
+            (_m = (_24 = this._driverInfo).userAgent) !== null && _m !== void 0 ? _m : (_24.userAgent = browserInfo.userAgent);
+            (_o = (_25 = this._driverInfo).pixelRatio) !== null && _o !== void 0 ? _o : (_25.pixelRatio = browserInfo.pixelRatio);
+            (_p = (_26 = this._driverInfo).viewportScale) !== null && _p !== void 0 ? _p : (_26.viewportScale = browserInfo.viewportScale);
             if (browserInfo.userAgentData) {
-                (_l = (_22 = this._driverInfo).isMobile) !== null && _l !== void 0 ? _l : (_22.isMobile = this._driverInfo.isMobile);
-                (_m = (_23 = this._driverInfo).isChromium) !== null && _m !== void 0 ? _m : (_23.isChromium = this._driverInfo.isChromium);
+                (_q = (_27 = this._driverInfo).isMobile) !== null && _q !== void 0 ? _q : (_27.isMobile = this._driverInfo.isMobile);
+                (_r = (_28 = this._driverInfo).isChromium) !== null && _r !== void 0 ? _r : (_28.isChromium = this._driverInfo.isChromium);
                 if (this.isChromium) {
                     if (this.isWindows && Number.parseInt(this.browserVersion) >= 107) {
-                        this._driverInfo.platformVersion = (_o = browserInfo.platformVersion) !== null && _o !== void 0 ? _o : this._driverInfo.platformVersion;
+                        this._driverInfo.platformVersion = (_s = browserInfo.platformVersion) !== null && _s !== void 0 ? _s : this._driverInfo.platformVersion;
                     }
                     else if (this.isMac && Number.parseInt(this.browserVersion) >= 90) {
-                        this._driverInfo.platformVersion = (_p = browserInfo.platformVersion) !== null && _p !== void 0 ? _p : this._driverInfo.platformVersion;
+                        this._driverInfo.platformVersion = (_t = browserInfo.platformVersion) !== null && _t !== void 0 ? _t : this._driverInfo.platformVersion;
                     }
                 }
             }
@@ -213,34 +216,35 @@ class Driver {
                 const userAgentInfo = (0, user_agent_1.parseUserAgent)(this._driverInfo.userAgent);
                 const userAgentDataInfo = browserInfo.userAgentData && (0, user_agent_data_1.parseUserAgentData)(browserInfo.userAgentData);
                 this._driverInfo.browserName =
-                    (_r = (_q = userAgentInfo.browserName) !== null && _q !== void 0 ? _q : userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.browserName) !== null && _r !== void 0 ? _r : this._driverInfo.browserName;
+                    (_v = (_u = userAgentInfo.browserName) !== null && _u !== void 0 ? _u : userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.browserName) !== null && _v !== void 0 ? _v : this._driverInfo.browserName;
                 this._driverInfo.browserVersion =
-                    (_t = (_s = userAgentInfo.browserVersion) !== null && _s !== void 0 ? _s : userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.browserVersion) !== null && _t !== void 0 ? _t : this._driverInfo.browserVersion;
-                (_u = (_24 = this._driverInfo).isMobile) !== null && _u !== void 0 ? _u : (_24.isMobile = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.isMobile);
-                (_v = (_25 = this._driverInfo).isChromium) !== null && _v !== void 0 ? _v : (_25.isChromium = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.isChromium);
+                    (_x = (_w = userAgentInfo.browserVersion) !== null && _w !== void 0 ? _w : userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.browserVersion) !== null && _x !== void 0 ? _x : this._driverInfo.browserVersion;
+                (_y = (_29 = this._driverInfo).isMobile) !== null && _y !== void 0 ? _y : (_29.isMobile = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.isMobile);
+                (_z = (_30 = this._driverInfo).isChromium) !== null && _z !== void 0 ? _z : (_30.isChromium = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.isChromium);
                 if (this._driverInfo.isMobile) {
-                    (_w = (_26 = this._driverInfo).platformName) !== null && _w !== void 0 ? _w : (_26.platformName = (_x = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformName) !== null && _x !== void 0 ? _x : userAgentInfo.platformName);
-                    (_y = (_27 = this._driverInfo).platformVersion) !== null && _y !== void 0 ? _y : (_27.platformVersion = (_z = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformVersion) !== null && _z !== void 0 ? _z : userAgentInfo.platformVersion);
+                    (_0 = (_31 = this._driverInfo).platformName) !== null && _0 !== void 0 ? _0 : (_31.platformName = (_1 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformName) !== null && _1 !== void 0 ? _1 : userAgentInfo.platformName);
+                    (_2 = (_32 = this._driverInfo).platformVersion) !== null && _2 !== void 0 ? _2 : (_32.platformVersion = (_3 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformVersion) !== null && _3 !== void 0 ? _3 : userAgentInfo.platformVersion);
                 }
                 else {
                     this._driverInfo.platformName =
-                        (_1 = (_0 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformName) !== null && _0 !== void 0 ? _0 : userAgentInfo.platformName) !== null && _1 !== void 0 ? _1 : this._driverInfo.platformName;
+                        (_5 = (_4 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformName) !== null && _4 !== void 0 ? _4 : userAgentInfo.platformName) !== null && _5 !== void 0 ? _5 : this._driverInfo.platformName;
                     this._driverInfo.platformVersion =
-                        (_3 = (_2 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformVersion) !== null && _2 !== void 0 ? _2 : userAgentInfo.platformVersion) !== null && _3 !== void 0 ? _3 : this._driverInfo.platformVersion;
+                        (_7 = (_6 = userAgentDataInfo === null || userAgentDataInfo === void 0 ? void 0 : userAgentDataInfo.platformVersion) !== null && _6 !== void 0 ? _6 : userAgentInfo.platformVersion) !== null && _7 !== void 0 ? _7 : this._driverInfo.platformVersion;
                 }
             }
             if (!this.isMobile && (this.isAndroid || this.isIOS)) {
                 this._driverInfo.isMobile = true;
                 this._driverInfo.isEmulation = this._driverInfo.isChrome;
             }
-            (_4 = (_28 = this._driverInfo).features) !== null && _4 !== void 0 ? _4 : (_28.features = {});
-            (_5 = (_29 = this._driverInfo.features).allCookies) !== null && _5 !== void 0 ? _5 : (_29.allCookies = this._driverInfo.isChrome || (/chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile));
+            (_8 = (_33 = this._driverInfo).features) !== null && _8 !== void 0 ? _8 : (_33.features = {});
+            (_9 = (_34 = this._driverInfo.features).allCookies) !== null && _9 !== void 0 ? _9 : (_34.allCookies = this._driverInfo.isChrome ||
+                (!!this._driverInfo.browserName && /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile));
         }
         else {
             // this value always excludes the height of the navigation bar, and sometimes it also excludes the height of the status bar
             let windowSize = await this._spec.getWindowSize(this.target);
-            (_6 = (_30 = this._driverInfo).displaySize) !== null && _6 !== void 0 ? _6 : (_30.displaySize = windowSize);
-            if (((_7 = this.orientation) === null || _7 === void 0 ? void 0 : _7.startsWith('landscape')) &&
+            (_10 = (_35 = this._driverInfo).displaySize) !== null && _10 !== void 0 ? _10 : (_35.displaySize = windowSize);
+            if (((_11 = this.orientation) === null || _11 === void 0 ? void 0 : _11.startsWith('landscape')) &&
                 this._driverInfo.displaySize.height > this._driverInfo.displaySize.width) {
                 this._driverInfo.displaySize = {
                     width: this._driverInfo.displaySize.height,
@@ -249,14 +253,14 @@ class Driver {
             }
             if (this.isAndroid) {
                 // bar sizes could be extracted only on android
-                const systemBars = await ((_9 = (_8 = this._spec).getSystemBars) === null || _9 === void 0 ? void 0 : _9.call(_8, this.target).catch(() => null));
+                const systemBars = await ((_13 = (_12 = this._spec).getSystemBars) === null || _13 === void 0 ? void 0 : _13.call(_12, this.target).catch(() => null));
                 const { statusBar, navigationBar } = systemBars !== null && systemBars !== void 0 ? systemBars : {};
                 if (statusBar === null || statusBar === void 0 ? void 0 : statusBar.visible) {
                     this._logger.log('Driver status bar', statusBar);
                     const statusBarSize = statusBar.height;
                     // when status bar is overlapping content on android it returns status bar height equal to display height
                     if (statusBarSize < this._driverInfo.displaySize.height) {
-                        this._driverInfo.statusBarSize = Math.max((_10 = this._driverInfo.statusBarSize) !== null && _10 !== void 0 ? _10 : 0, statusBarSize);
+                        this._driverInfo.statusBarSize = Math.max((_14 = this._driverInfo.statusBarSize) !== null && _14 !== void 0 ? _14 : 0, statusBarSize);
                     }
                 }
                 if (navigationBar === null || navigationBar === void 0 ? void 0 : navigationBar.visible) {
@@ -265,28 +269,28 @@ class Driver {
                     if (navigationBar.x > 0)
                         this._driverInfo.orientation = 'landscape-secondary';
                     // navigation bar size could be its height or width depending on screen orientation
-                    const navigationBarSize = navigationBar[((_11 = this.orientation) === null || _11 === void 0 ? void 0 : _11.startsWith('landscape')) ? 'width' : 'height'];
+                    const navigationBarSize = navigationBar[((_15 = this.orientation) === null || _15 === void 0 ? void 0 : _15.startsWith('landscape')) ? 'width' : 'height'];
                     // when navigation bar is invisible on android it returns navigation bar size equal to display size
                     if (navigationBarSize <
-                        this._driverInfo.displaySize[((_12 = this.orientation) === null || _12 === void 0 ? void 0 : _12.startsWith('landscape')) ? 'width' : 'height']) {
-                        this._driverInfo.navigationBarSize = Math.max((_13 = this._driverInfo.navigationBarSize) !== null && _13 !== void 0 ? _13 : 0, navigationBarSize);
+                        this._driverInfo.displaySize[((_16 = this.orientation) === null || _16 === void 0 ? void 0 : _16.startsWith('landscape')) ? 'width' : 'height']) {
+                        this._driverInfo.navigationBarSize = Math.max((_17 = this._driverInfo.navigationBarSize) !== null && _17 !== void 0 ? _17 : 0, navigationBarSize);
                     }
                     else {
                         this._driverInfo.navigationBarSize = 0;
                     }
                 }
                 // bar sizes have to be scaled on android
-                (_31 = this._driverInfo).statusBarSize && (_31.statusBarSize = this._driverInfo.statusBarSize / this.pixelRatio);
-                (_32 = this._driverInfo).navigationBarSize && (_32.navigationBarSize = this._driverInfo.navigationBarSize / this.pixelRatio);
+                (_36 = this._driverInfo).statusBarSize && (_36.statusBarSize = this._driverInfo.statusBarSize / this.pixelRatio);
+                (_37 = this._driverInfo).navigationBarSize && (_37.navigationBarSize = this._driverInfo.navigationBarSize / this.pixelRatio);
                 windowSize = utils.geometry.scale(windowSize, 1 / this.pixelRatio);
-                (_33 = this._driverInfo).displaySize && (_33.displaySize = utils.geometry.scale(this._driverInfo.displaySize, 1 / this.pixelRatio));
+                (_38 = this._driverInfo).displaySize && (_38.displaySize = utils.geometry.scale(this._driverInfo.displaySize, 1 / this.pixelRatio));
             }
             if (this.isIOS) {
-                if ((_14 = this.orientation) === null || _14 === void 0 ? void 0 : _14.startsWith('landscape'))
+                if ((_18 = this.orientation) === null || _18 === void 0 ? void 0 : _18.startsWith('landscape'))
                     this._driverInfo.statusBarSize = 0;
             }
             // calculate viewport location
-            (_15 = (_34 = this._driverInfo).viewportLocation) !== null && _15 !== void 0 ? _15 : (_34.viewportLocation = {
+            (_19 = (_39 = this._driverInfo).viewportLocation) !== null && _19 !== void 0 ? _19 : (_39.viewportLocation = {
                 x: this.orientation === 'landscape' ? this.navigationBarSize : 0,
                 y: this.statusBarSize,
             });
@@ -295,21 +299,27 @@ class Driver {
                 this._driverInfo.viewportSize = { ...this._driverInfo.displaySize };
                 this._driverInfo.viewportSize.height -= this.statusBarSize;
                 if (this.isAndroid) {
-                    this._driverInfo.viewportSize[((_16 = this.orientation) === null || _16 === void 0 ? void 0 : _16.startsWith('landscape')) ? 'width' : 'height'] -=
+                    this._driverInfo.viewportSize[((_20 = this.orientation) === null || _20 === void 0 ? void 0 : _20.startsWith('landscape')) ? 'width' : 'height'] -=
                         this.navigationBarSize;
                 }
             }
             // calculate safe area
             if (this.isIOS && !this._driverInfo.safeArea) {
                 this._driverInfo.safeArea = { x: 0, y: 0, ...this._driverInfo.displaySize };
-                const topElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeNavigationBar' });
+                const topElement = await this.element({
+                    type: '-ios class chain',
+                    selector: '**/XCUIElementTypeNavigationBar',
+                });
                 if (topElement) {
                     const topRegion = await this._spec.getElementRegion(this.target, topElement.target);
                     const topOffset = topRegion.y + topRegion.height;
                     this._driverInfo.safeArea.y = topOffset;
                     this._driverInfo.safeArea.height -= topOffset;
                 }
-                const bottomElement = await this.element({ type: '-ios class chain', selector: '**/XCUIElementTypeTabBar' });
+                const bottomElement = await this.element({
+                    type: '-ios class chain',
+                    selector: '**/XCUIElementTypeTabBar',
+                });
                 if (bottomElement) {
                     const bottomRegion = await this._spec.getElementRegion(this.target, bottomElement.target);
                     const bottomOffset = bottomRegion.height;
@@ -318,12 +328,12 @@ class Driver {
             }
             // TODO: if user opts into NML, skip initializing the helpers
             // init helper lib
-            if (!((_17 = this._customConfig) === null || _17 === void 0 ? void 0 : _17.disableHelper)) {
+            if (!((_21 = this._customConfig) === null || _21 === void 0 ? void 0 : _21.disableHelper)) {
                 this._helper = this.isIOS
                     ? await helper_ios_1.HelperIOS.make({ spec: this._spec, driver: this, logger: this._logger })
                     : await helper_android_1.HelperAndroid.make({ spec: this._spec, driver: this, logger: this._logger });
             }
-            this._logger.log(`Helper set to ${(_18 = this._helper) === null || _18 === void 0 ? void 0 : _18.name}`);
+            this._logger.log(`Helper set to ${(_22 = this._helper) === null || _22 === void 0 ? void 0 : _22.name}`);
         }
         this._logger.log('Combined driver info', this._driverInfo);
         return this;
@@ -377,7 +387,7 @@ class Driver {
     async getWorlds(attempt = 1) {
         var _a, _b;
         if (!this._spec.getWorlds)
-            return;
+            return [];
         this._logger.log('attempting to find worlds');
         await utils.general.sleep(500);
         const worlds = await ((_b = (_a = this._spec).getWorlds) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
@@ -395,7 +405,7 @@ class Driver {
     async getCurrentWorld() {
         var _a, _b;
         if (!this._spec.getCurrentWorld)
-            return;
+            return undefined;
         const [origin, next] = await this.getWorlds();
         const currentWorld = await ((_b = (_a = this._spec).getCurrentWorld) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
         const result = {
@@ -410,9 +420,9 @@ class Driver {
     }
     // end world
     async getSessionMetadata() {
-        var _a;
-        if (this.isExecutionGridClient)
-            return await ((_a = this._spec) === null || _a === void 0 ? void 0 : _a.getSessionMetadata(this.target));
+        var _a, _b;
+        if (this.isECClient)
+            return await ((_b = (_a = this._spec).getSessionMetadata) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
     }
     async refreshContexts() {
         if (this.isNative)
@@ -446,7 +456,10 @@ class Driver {
         }
         async function getChildContextsInfo(context) {
             const framesInfo = await spec.executeScript(context, snippets.getChildFramesInfo);
-            return framesInfo.map(([contextElement, isCORS]) => ({ contextElement, isCORS }));
+            return framesInfo.map(([contextElement, isCORS]) => ({
+                contextElement,
+                isCORS,
+            }));
         }
         async function isEqualElements(context, element1, element2) {
             return spec.executeScript(context, snippets.isEqualElements, [element1, element2]).catch(() => false);
@@ -467,6 +480,7 @@ class Driver {
                 if (isWantedContext)
                     return childContextInfo.contextElement;
             }
+            return null;
         }
         async function findContextPath(context, contextInfo, contextPath = []) {
             const contentDocument = await spec.findElement(context, transformSelector('html'));
@@ -488,8 +502,7 @@ class Driver {
     }
     async switchTo(context) {
         if (await this.currentContext.equals(context)) {
-            this._currentContext = context;
-            return;
+            return (this._currentContext = context);
         }
         const currentPath = this.currentContext.path;
         const requiredPath = context.path;
@@ -583,10 +596,14 @@ class Driver {
         if (this.isAndroid) {
             normalizedRegion = utils.geometry.scale(normalizedRegion, 1 / this.pixelRatio);
         }
-        if (this.isIOS && utils.geometry.isIntersected(normalizedRegion, this._driverInfo.safeArea)) {
+        if (this.isIOS &&
+            this._driverInfo.safeArea &&
+            utils.geometry.isIntersected(normalizedRegion, this._driverInfo.safeArea)) {
             normalizedRegion = utils.geometry.intersect(normalizedRegion, this._driverInfo.safeArea);
         }
-        normalizedRegion = utils.geometry.offsetNegative(normalizedRegion, this._driverInfo.viewportLocation);
+        if (this._driverInfo.viewportLocation) {
+            normalizedRegion = utils.geometry.offsetNegative(normalizedRegion, this._driverInfo.viewportLocation);
+        }
         if (normalizedRegion.y < 0) {
             normalizedRegion.height += normalizedRegion.y;
             normalizedRegion.y = 0;
@@ -603,6 +620,9 @@ class Driver {
     async elements(selector) {
         return this.currentContext.elements(selector);
     }
+    async waitFor(selector, options) {
+        return this.currentContext.waitFor(selector, options);
+    }
     async execute(script, arg) {
         return this.currentContext.execute(script, arg);
     }
@@ -690,7 +710,7 @@ class Driver {
     async getDisplaySize() {
         var _a, _b;
         if (this.isWeb && !this.isMobile)
-            return;
+            return undefined;
         if ((_a = this._driverInfo) === null || _a === void 0 ? void 0 : _a.displaySize) {
             this._logger.log('Extracting display size from native driver using cached value');
             return this._driverInfo.displaySize;
@@ -705,8 +725,7 @@ class Driver {
     }
     async getOrientation() {
         if (this.isWeb && !this.isMobile)
-            return;
-        let orientation;
+            return undefined;
         if (this.isAndroid) {
             this._logger.log('Extracting device orientation using adb command on android');
             const rotation = await this.execute('mobile:shell', {
@@ -714,65 +733,73 @@ class Driver {
             })
                 .then(r => { var _a; return (_a = r === null || r === void 0 ? void 0 : r.trim) === null || _a === void 0 ? void 0 : _a.call(r); })
                 .catch(() => null);
-            if (rotation === 'ROTATION_0' || rotation === '0')
-                orientation = 'portrait';
-            else if (rotation === 'ROTATION_90' || rotation === '3')
-                orientation = 'landscape-secondary';
-            else if (rotation === 'ROTATION_180' || rotation === '2')
-                orientation = 'portrait-secondary';
-            else if (rotation === 'ROTATION_270' || rotation === '1')
-                orientation = 'landscape';
-        }
-        if (!orientation) {
-            this._logger.log('Extracting device orientation');
-            orientation = await this._spec.getOrientation(this.target);
+            if (rotation) {
+                let orientation = undefined;
+                if (rotation === 'ROTATION_0' || rotation === '0')
+                    orientation = 'portrait';
+                else if (rotation === 'ROTATION_90' || rotation === '3')
+                    orientation = 'landscape-secondary';
+                else if (rotation === 'ROTATION_180' || rotation === '2')
+                    orientation = 'portrait-secondary';
+                else if (rotation === 'ROTATION_270' || rotation === '1')
+                    orientation = 'landscape';
+                this._logger.log('Extracted device orientation:', orientation);
+                return orientation;
+            }
         }
+        this._logger.log('Extracting device orientation');
+        const orientation = await this._spec.getOrientation(this.target);
         this._logger.log('Extracted device orientation:', orientation);
         return orientation;
     }
     async setOrientation(orientation) {
         if (this.isWeb && !this.isMobile)
-            return;
+            return undefined;
         this._logger.log('Set device orientation:', orientation);
         await this._spec.setOrientation(this.target, orientation);
     }
     async getCookies() {
-        var _a, _b, _c;
-        if (this.isNative || !this.features.allCookies)
+        var _a, _b, _c, _d, _e;
+        var _f;
+        if (this.isNative || !((_a = this.features) === null || _a === void 0 ? void 0 : _a.allCookies))
             return [];
         try {
-            return (_c = (await ((_b = (_a = this._spec).getCookies) === null || _b === void 0 ? void 0 : _b.call(_a, this.target)))) !== null && _c !== void 0 ? _c : [];
+            return (_d = (await ((_c = (_b = this._spec).getCookies) === null || _c === void 0 ? void 0 : _c.call(_b, this.target)))) !== null && _d !== void 0 ? _d : [];
         }
         catch (error) {
+            (_e = (_f = this._driverInfo).features) !== null && _e !== void 0 ? _e : (_f.features = {});
             this._driverInfo.features.allCookies = false;
             throw error;
         }
     }
     async getTitle() {
         if (this.isNative)
-            return null;
+            return undefined;
         const title = await this._spec.getTitle(this.target);
         this._logger.log('Extracted title:', title);
         return title;
     }
     async getUrl() {
         if (this.isNative)
-            return null;
+            return undefined;
         const url = await this._spec.getUrl(this.target);
         this._logger.log('Extracted url:', url);
         return url;
     }
     async visit(url) {
-        await this._spec.visit(this.target, url);
+        var _a, _b;
+        await ((_b = (_a = this._spec).visit) === null || _b === void 0 ? void 0 : _b.call(_a, this.target, url));
     }
 }
 exports.Driver = Driver;
 function isDriver(driver, spec) {
-    return driver instanceof Driver || (spec === null || spec === void 0 ? void 0 : spec.isDriver(driver));
+    return driver instanceof Driver || !!(spec === null || spec === void 0 ? void 0 : spec.isDriver(driver));
 }
 exports.isDriver = isDriver;
 async function makeDriver(options) {
-    const driver = new Driver(options);
+    const driver = options.driver instanceof Driver
+        ? options.driver
+        : new Driver(options);
     await driver.init();
     await driver.refreshContexts();
     return driver;

package/dist/element.js

@@ -23,26 +23,24 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Element = void 0;
+exports.isElementReference = exports.Element = void 0;
 const utils = __importStar(require("@applitools/utils"));
 const specUtils = __importStar(require("./spec-utils"));
 const snippets = require('@applitools/snippets');
 class Element {
     constructor(options) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         this._state = {};
-        if (options.element instanceof Element)
-            return options.element;
         this._spec = options.spec;
-        if (options.context)
-            this._context = options.context;
-        if (options.logger)
-            this._logger = options.logger;
-        this._target = (_c = (_b = (_a = this._spec).transformElement) === null || _b === void 0 ? void 0 : _b.call(_a, options.element)) !== null && _c !== void 0 ? _c : options.element;
-        if (this._spec.isElement(this._target)) {
-            // Some frameworks contains information about the selector inside an element
-            this._selector = (_d = options.selector) !== null && _d !== void 0 ? _d : (_f = (_e = this._spec).extractSelector) === null || _f === void 0 ? void 0 : _f.call(_e, options.element);
-            this._index = options.index;
+        this._context = options.context;
+        this._logger = options.logger;
+        if (utils.types.has(options, 'element')) {
+            this._target = (_c = (_b = (_a = this._spec).transformElement) === null || _b === void 0 ? void 0 : _b.call(_a, options.element)) !== null && _c !== void 0 ? _c : options.element;
+            if (this._spec.isElement(this._target)) {
+                // Some frameworks contains information about the selector inside an element
+                this._selector = (_d = options.selector) !== null && _d !== void 0 ? _d : (_f = (_e = this._spec).extractSelector) === null || _f === void 0 ? void 0 : _f.call(_e, options.element);
+                this._index = options.index;
+            }
         }
         else if (specUtils.isSelector(this._spec, options.selector)) {
             this._selector = options.selector;
@@ -54,11 +52,14 @@ class Element {
             this._commonSelector = this._selector;
         }
         else if (this._selector && this._spec.untransformSelector) {
-            this._commonSelector = this._spec.untransformSelector(this._spec.transformSelector(this._selector));
+            this._commonSelector = this._spec.untransformSelector((_j = (_h = (_g = this._spec).transformSelector) === null || _h === void 0 ? void 0 : _h.call(_g, this._selector)) !== null && _j !== void 0 ? _j : this._selector);
         }
         else if (utils.types.isString(this._selector)) {
             this._commonSelector = { selector: this._selector };
         }
+        else {
+            this._commonSelector = null;
+        }
     }
     get target() {
         return this._target;
@@ -79,9 +80,11 @@ class Element {
         return this.context.driver;
     }
     get isRef() {
-        return this.context.isRef || !this.target;
+        var _a;
+        return ((_a = this.context) === null || _a === void 0 ? void 0 : _a.isRef) || !this.target;
     }
     async equals(element) {
+        var _a, _b, _c;
         if (this.isRef)
             return false;
         element = element instanceof Element ? element.target : element;
@@ -91,7 +94,7 @@ class Element {
                 .catch(() => false);
         }
         else {
-            return this._spec.isEqualElements(this.context.target, this.target, element);
+            return (_c = (_b = (_a = this._spec).isEqualElements) === null || _b === void 0 ? void 0 : _b.call(_a, this.context.target, this.target, element)) !== null && _c !== void 0 ? _c : false;
         }
     }
     async contains(innerElement) {
@@ -132,8 +135,8 @@ class Element {
             if (!element)
                 throw new Error(`Cannot find element with selector ${JSON.stringify(this._selector)}`);
             this._target = element.target;
-            return this;
         }
+        return this;
     }
     async getRegion() {
         const region = await this.withRefresh(async () => {
@@ -172,12 +175,12 @@ class Element {
     async getContentRegion(options = {}) {
         var _a, _b, _c;
         if (!this.driver.isNative)
-            return;
+            return null;
         this._logger.log('Extracting content region of native element with selector', this.selector);
         let contentRegion = await ((_a = this.driver.helper) === null || _a === void 0 ? void 0 : _a.getContentRegion(this, options));
         this._logger.log('Extracted content region using helper library', contentRegion);
         if (!contentRegion || !this.driver.isAndroid) {
-            let attrContentRegion;
+            let attrContentRegion = null;
             try {
                 const size = JSON.parse(await this.getAttribute('contentSize'));
                 attrContentRegion = {
@@ -228,9 +231,6 @@ class Element {
         }
         return contentRegion !== null && contentRegion !== void 0 ? contentRegion : (await this._spec.getElementRegion(this.driver.target, this.target));
     }
-    async getContentSizeIOS() {
-        return this._spec.getElementRegion(this.driver.target, this.target);
-    }
     async getContentSize(options = {}) {
         if (this._state.contentSize)
             return this._state.contentSize;
@@ -599,11 +599,14 @@ class Element {
         }
     }
     async click() {
-        await this._spec.click(this.context.target, this.target);
+        var _a, _b;
+        this._logger.log(`Clicking on the element with selector`, this.selector);
+        await ((_b = (_a = this._spec).click) === null || _b === void 0 ? void 0 : _b.call(_a, this.context.target, this.target));
     }
     async type(value) {
-        this._logger.log(`Typing text "${value}" in element with selector`, this.selector);
-        await this._spec.setElementText(this.context.target, this.target, value);
+        var _a, _b;
+        this._logger.log(`Typing text "${value}" in the element with selector`, this.selector);
+        await ((_b = (_a = this._spec).setElementText) === null || _b === void 0 ? void 0 : _b.call(_a, this.context.target, this.target, value));
     }
     async preserveState() {
         const scrollOffset = await this.getScrollOffset();
@@ -622,8 +625,8 @@ class Element {
         if (state.transforms)
             await this.context.execute(snippets.setElementStyleProperties, [this, state.transforms]);
         if (state === this._state) {
-            this._state.scrollOffset = null;
-            this._state.transforms = null;
+            this._state.scrollOffset = undefined;
+            this._state.transforms = undefined;
         }
     }
     async hideScrollbars() {
@@ -690,3 +693,7 @@ class Element {
     }
 }
 exports.Element = Element;
+function isElementReference(reference, spec) {
+    return !!spec && (spec.isElement(reference) || specUtils.isSelector(spec, reference));
+}
+exports.isElementReference = isElementReference;