@applitools/driver 1.9.21 → 1.9.24

package/dist/context.js

@@ -258,16 +258,13 @@ class Context {
             throw new TypeError('Cannot find element using argument of unknown type!');
         }
     }
-    async elements(elementOrSelector) {
-        if (this._spec.isElement(elementOrSelector)) {
-            return [new element_1.Element({ spec: this._spec, context: this, element: elementOrSelector, logger: this._logger })];
-        }
-        else if (specUtils.isSelector(this._spec, elementOrSelector)) {
+    async elements(selectorOrElement) {
+        if (specUtils.isSelector(this._spec, selectorOrElement)) {
             if (this.isRef) {
-                return [new element_1.Element({ spec: this._spec, context: this, selector: elementOrSelector, logger: this._logger })];
+                return [new element_1.Element({ spec: this._spec, context: this, selector: selectorOrElement, logger: this._logger })];
             }
-            this._logger.log('Finding elements by selector: ', elementOrSelector);
-            const root = await this.root(elementOrSelector);
+            this._logger.log('Finding elements by selector: ', selectorOrElement);
+            const root = await this.root(selectorOrElement);
             if (!root)
                 return [];
             const elements = await this._spec.findElements(root.context.target, specUtils.transformSelector(this._spec, root.selector, this.driver), root.shadow && (await root.shadow.getShadowRoot()));
@@ -283,6 +280,9 @@ class Context {
                 });
             });
         }
+        else if (this._spec.isElement(selectorOrElement)) {
+            return [new element_1.Element({ spec: this._spec, context: this, element: selectorOrElement, logger: this._logger })];
+        }
         else {
             throw new TypeError('Cannot find elements using argument of unknown type!');
         }

package/dist/driver.js

@@ -144,8 +144,8 @@ class Driver {
         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;
-        var _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14;
+        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;
+        var _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15;
         const capabilities = await ((_b = (_a = this._spec).getCapabilities) === null || _b === void 0 ? void 0 : _b.call(_a, this.target));
         this._logger.log('Driver capabilities', capabilities);
         const capabilitiesInfo = capabilities ? (0, capabilities_1.parseCapabilities)(capabilities, this._customConfig) : undefined;
@@ -156,29 +156,29 @@ class Driver {
                 (_e = (await this.getOrientation().catch(() => undefined))) !== null && _e !== void 0 ? _e : this._driverInfo.orientation;
         }
         if (this.isWeb) {
-            (_f = (_3 = this._driverInfo).pixelRatio) !== null && _f !== void 0 ? _f : (_3.pixelRatio = await this.execute(snippets.getPixelRatio));
-            (_g = (_4 = this._driverInfo).viewportScale) !== null && _g !== void 0 ? _g : (_4.viewportScale = await this.execute(snippets.getViewportScale));
-            (_h = (_5 = this._driverInfo).userAgent) !== null && _h !== void 0 ? _h : (_5.userAgent = await this.execute(snippets.getUserAgent));
+            (_f = (_4 = this._driverInfo).pixelRatio) !== null && _f !== void 0 ? _f : (_4.pixelRatio = await this.execute(snippets.getPixelRatio));
+            (_g = (_5 = this._driverInfo).viewportScale) !== null && _g !== void 0 ? _g : (_5.viewportScale = await this.execute(snippets.getViewportScale));
+            (_h = (_6 = this._driverInfo).userAgent) !== null && _h !== void 0 ? _h : (_6.userAgent = await this.execute(snippets.getUserAgent));
             if (this._driverInfo.userAgent) {
                 const userAgentInfo = (0, user_agent_1.parseUserAgent)(this._driverInfo.userAgent);
                 this._driverInfo.browserName = (_j = userAgentInfo.browserName) !== null && _j !== void 0 ? _j : this._driverInfo.browserName;
                 this._driverInfo.browserVersion = (_k = userAgentInfo.browserVersion) !== null && _k !== void 0 ? _k : this._driverInfo.browserVersion;
                 if (this._driverInfo.isMobile) {
-                    (_l = (_6 = this._driverInfo).platformName) !== null && _l !== void 0 ? _l : (_6.platformName = userAgentInfo.platformName);
-                    (_m = (_7 = this._driverInfo).platformVersion) !== null && _m !== void 0 ? _m : (_7.platformVersion = userAgentInfo.platformVersion);
+                    (_l = (_7 = this._driverInfo).platformName) !== null && _l !== void 0 ? _l : (_7.platformName = userAgentInfo.platformName);
+                    (_m = (_8 = this._driverInfo).platformVersion) !== null && _m !== void 0 ? _m : (_8.platformVersion = userAgentInfo.platformVersion);
                 }
                 else {
                     this._driverInfo.platformName = (_o = userAgentInfo.platformName) !== null && _o !== void 0 ? _o : this._driverInfo.platformName;
                     this._driverInfo.platformVersion = (_p = userAgentInfo.platformVersion) !== null && _p !== void 0 ? _p : this._driverInfo.platformVersion;
                 }
             }
-            (_q = (_8 = this._driverInfo).features) !== null && _q !== void 0 ? _q : (_8.features = {});
-            (_r = (_9 = this._driverInfo.features).allCookies) !== null && _r !== void 0 ? _r : (_9.allCookies = /chrome/i.test(this._driverInfo.browserName) && !this._driverInfo.isMobile);
+            (_q = (_9 = this._driverInfo).features) !== null && _q !== void 0 ? _q : (_9.features = {});
+            (_r = (_10 = this._driverInfo.features).allCookies) !== null && _r !== void 0 ? _r : (_10.allCookies = /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);
-            (_s = (_10 = this._driverInfo).displaySize) !== null && _s !== void 0 ? _s : (_10.displaySize = windowSize);
+            (_s = (_11 = this._driverInfo).displaySize) !== null && _s !== void 0 ? _s : (_11.displaySize = windowSize);
             if (((_t = this.orientation) === null || _t === void 0 ? void 0 : _t.startsWith('landscape')) &&
                 this._driverInfo.displaySize.height > this._driverInfo.displaySize.width) {
                 this._driverInfo.displaySize = {
@@ -215,17 +215,17 @@ class Driver {
                     }
                 }
                 // bar sizes have to be scaled on android
-                (_11 = this._driverInfo).statusBarSize && (_11.statusBarSize = this._driverInfo.statusBarSize / this.pixelRatio);
-                (_12 = this._driverInfo).navigationBarSize && (_12.navigationBarSize = this._driverInfo.navigationBarSize / this.pixelRatio);
+                (_12 = this._driverInfo).statusBarSize && (_12.statusBarSize = this._driverInfo.statusBarSize / this.pixelRatio);
+                (_13 = this._driverInfo).navigationBarSize && (_13.navigationBarSize = this._driverInfo.navigationBarSize / this.pixelRatio);
                 windowSize = utils.geometry.scale(windowSize, 1 / this.pixelRatio);
-                (_13 = this._driverInfo).displaySize && (_13.displaySize = utils.geometry.scale(this._driverInfo.displaySize, 1 / this.pixelRatio));
+                (_14 = this._driverInfo).displaySize && (_14.displaySize = utils.geometry.scale(this._driverInfo.displaySize, 1 / this.pixelRatio));
             }
             if (this.isIOS) {
                 if ((_0 = this.orientation) === null || _0 === void 0 ? void 0 : _0.startsWith('landscape'))
                     this._driverInfo.statusBarSize = 0;
             }
             // calculate viewport location
-            (_1 = (_14 = this._driverInfo).viewportLocation) !== null && _1 !== void 0 ? _1 : (_14.viewportLocation = {
+            (_1 = (_15 = this._driverInfo).viewportLocation) !== null && _1 !== void 0 ? _1 : (_15.viewportLocation = {
                 x: this.orientation === 'landscape' ? this.navigationBarSize : 0,
                 y: this.statusBarSize,
             });
@@ -255,10 +255,13 @@ class Driver {
                     this._driverInfo.safeArea.height -= bottomOffset;
                 }
             }
+            // TODO: if user opts into NML, skip initializing the helpers
             // init helper lib
-            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 });
+            if (!((_3 = this._customConfig) === null || _3 === void 0 ? void 0 : _3.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('Combined driver info', this._driverInfo);
         return this;

package/dist/element.js

@@ -190,7 +190,7 @@ class Element {
         this._logger.log('Extracted client region', region);
         return region;
     }
-    async getContentSize() {
+    async getContentSize(options = {}) {
         if (this._state.contentSize)
             return this._state.contentSize;
         const size = await this.withRefresh(async () => {
@@ -202,7 +202,7 @@ class Element {
             else {
                 this._logger.log('Extracting content size of native element with selector', this.selector);
                 try {
-                    let contentRegion = await ((_a = this.driver.helper) === null || _a === void 0 ? void 0 : _a.getContentRegion(this));
+                    let contentRegion = await ((_a = this.driver.helper) === null || _a === void 0 ? void 0 : _a.getContentRegion(this, options));
                     this._logger.log('Extracted native content region using helper library', contentRegion);
                     // on android extraction of this argument will perform non-deterministic touch action, so it is better to avoid it
                     if (!contentRegion || !this.driver.isAndroid) {

package/dist/fake/mock-driver.js

@@ -273,7 +273,7 @@ class MockDriver {
             : null;
     }
     async findElements(selector, rootElement) {
-        const elements = this._elements.get(selector);
+        const elements = this._elements.get(typeof selector === 'string' ? selector : selector.id);
         return elements
             ? elements.filter(element => element.parentContextId === this._contextId &&
                 element.parentRootId === ((rootElement || {}).shadowRootId || null))

package/dist/fake/spec-driver.js

@@ -30,11 +30,15 @@ function isDriver(driver) {
 }
 exports.isDriver = isDriver;
 function isElement(element) {
+    if ((element === null || element === void 0 ? void 0 : element.notting) === true)
+        return false;
     return utils.types.has(element, 'id');
 }
 exports.isElement = isElement;
 function isSelector(selector) {
-    return utils.types.isString(selector) || utils.types.has(selector, ['using', 'value']);
+    if ((selector === null || selector === void 0 ? void 0 : selector.notting) === true)
+        return false;
+    return (utils.types.isString(selector) || utils.types.has(selector, ['using', 'value']) || (selector === null || selector === void 0 ? void 0 : selector.forceSelector) === true);
 }
 exports.isSelector = isSelector;
 function transformSelector(selector) {

package/dist/helper-android.js

@@ -1,16 +1,47 @@
 "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 });
 exports.HelperAndroid = void 0;
+const utils = __importStar(require("@applitools/utils"));
+const gte_1 = __importDefault(require("semver/functions/gte"));
 class HelperAndroid {
     constructor(options) {
+        this._supportAsync = false;
         this._spec = options.spec;
         this._input = options.input;
         this._action = options.action;
         this._legacy = options.legacy;
         this._logger = options.logger;
         this.name = this._legacy ? 'android-legacy' : 'android';
+        this._supportAsync = options.supportAsync === true;
     }
     static async make(options) {
+        var _a;
         const { spec, driver, logger } = options;
         let legacy = false;
         let input = await driver.element({ type: 'xpath', selector: '//*[@content-desc="EyesAppiumHelperEDT"]' });
@@ -18,11 +49,23 @@ class HelperAndroid {
             legacy = true;
             input = await driver.element({ type: 'xpath', selector: '//*[@content-desc="EyesAppiumHelper"]' });
         }
+        const versionElement = await driver.element({
+            type: 'xpath',
+            selector: '//*[@content-desc="EyesAppiumHelper_Version"]',
+        });
+        const version = (_a = (await (versionElement === null || versionElement === void 0 ? void 0 : versionElement.getText()))) !== null && _a !== void 0 ? _a : '0.0.0';
         const action = !legacy
             ? await driver.element({ type: 'xpath', selector: '//*[@content-desc="EyesAppiumHelper_Action"]' })
             : null;
         return input
-            ? new HelperAndroid({ spec, input, action, legacy, logger })
+            ? new HelperAndroid({
+                spec,
+                input,
+                action,
+                legacy,
+                logger,
+                supportAsync: (0, gte_1.default)(version, '1.8.0'),
+            })
             : null;
     }
     async _getElementId(element) {
@@ -39,31 +82,49 @@ class HelperAndroid {
             await this._action.type('1').catch(() => null);
             text = await this._input.getText();
         }
+        // wait until the JAVA complete the async operation
+        const timeout = 5 * 60 * 1000;
+        const finishAt = Date.now() + timeout;
+        while (text === 'WAIT' && finishAt > Date.now()) {
+            await utils.general.sleep(1000);
+            text = await this._input.getText();
+        }
+        if (text === 'WAIT') {
+            this._logger.warn(`Helper library didn't provide a response for async command (${command}) during ${timeout}ms`);
+            text = null;
+        }
         await this._input.type('');
         return text;
     }
-    async getContentRegion(element) {
+    async getContentRegion(element, options) {
+        var _a, _b, _c;
+        const elementId = await this._getElementId(element);
+        if (!elementId)
+            return null;
         let contentHeightString;
         if (this._legacy) {
             await this._input.click();
             contentHeightString = await this._input.getText();
         }
+        else if (this._supportAsync && ((_a = options === null || options === void 0 ? void 0 : options.lazyLoad) === null || _a === void 0 ? void 0 : _a.waitingTime)) {
+            const result = await this._command(`offset_async;${elementId};0;0;0;${(_c = (_b = options === null || options === void 0 ? void 0 : options.lazyLoad) === null || _b === void 0 ? void 0 : _b.waitingTime) !== null && _c !== void 0 ? _c : 0}`);
+            contentHeightString = result.split(';')[0];
+        }
         else {
-            const elementId = await this._getElementId(element);
-            if (!elementId)
-                return null;
-            contentHeightString = await this._command(`offset;${elementId};0;0;0`);
+            contentHeightString = await this._command(`'offset';${elementId};0;0;0;0`);
         }
-        const region = await this._spec.getElementRegion(this._input.driver.target, element.target);
         const contentHeight = Number(contentHeightString);
-        return !Number.isNaN(contentHeight) && contentHeight >= region.height
-            ? { x: region.x, y: region.y, width: region.width, height: contentHeight }
-            : null;
+        if (Number.isNaN(contentHeight))
+            return null;
+        const region = await this._spec.getElementRegion(this._input.driver.target, element.target);
+        if (contentHeight < region.height)
+            return null;
+        return { x: region.x, y: region.y, width: region.width, height: contentHeight };
     }
     async getTouchPadding() {
         if (this._legacy)
             return null;
-        const touchPaddingString = await this._command(`getTouchPadding;0;0;0;0`);
+        const touchPaddingString = await this._command(`getTouchPadding;0;0;0;0;0`);
         const touchPadding = Number(touchPaddingString);
         if (!touchPadding || Number.isNaN(touchPadding))
             return null;
@@ -75,7 +136,7 @@ class HelperAndroid {
         const elementId = await this._getElementId(element);
         if (!elementId)
             return null;
-        const regionString = await this._command(`getRect;${elementId};0;0`);
+        const regionString = await this._command(`getRect;${elementId};0;0;0`);
         if (!regionString)
             return null;
         const [, x, y, height, width] = regionString.match(/\[(-?\d+(?:\.\d+)?);(-?\d+(?:\.\d+)?);(-?\d+(?:\.\d+)?);(-?\d+(?:\.\d+)?)\]/);
@@ -90,7 +151,7 @@ class HelperAndroid {
         const elementId = await this._getElementId(element);
         if (!elementId)
             return null;
-        await this._command(`moveToTop;${elementId};0;-1`);
+        await this._command(`moveToTop;${elementId};0;-1;0`);
     }
     async scrollBy(element, offset) {
         if (this._legacy)
@@ -98,7 +159,7 @@ class HelperAndroid {
         const elementId = await this._getElementId(element);
         if (!elementId)
             return null;
-        await this._command(`scroll;${elementId};${offset.y};0;0`);
+        await this._command(`scroll;${elementId};${offset.y};0;0;0`);
     }
 }
 exports.HelperAndroid = HelperAndroid;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/driver",
-  "version": "1.9.21",
+  "version": "1.9.24",
   "description": "Applitools universal framework wrapper",
   "keywords": [
     "applitools",
@@ -80,8 +80,9 @@
   "dependencies": {
     "@applitools/logger": "1.1.16",
     "@applitools/snippets": "2.4.5",
-    "@applitools/types": "1.5.8",
-    "@applitools/utils": "1.3.10"
+    "@applitools/types": "1.5.9",
+    "@applitools/utils": "1.3.10",
+    "semver": "7.3.7"
   },
   "devDependencies": {
     "@applitools/bongo": "^2.1.6",

package/types/context.d.ts

@@ -54,7 +54,7 @@ export declare class Context<TDriver, TContext, TElement, TSelector> {
         selector: types.Selector<TSelector>;
     }>;
     element(elementOrSelector: TElement | types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>>;
-    elements(elementOrSelector: TElement | types.Selector<TSelector>): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
+    elements(selectorOrElement: types.Selector<TSelector> | TElement): Promise<Element<TDriver, TContext, TElement, TSelector>[]>;
     waitFor(selector: types.Selector<TSelector>, options?: types.WaitOptions): Promise<Element<TDriver, TContext, TElement, TSelector>>;
     execute(script: ((args: any) => any) | string, arg?: any): Promise<any>;
     getContextElement(): Promise<Element<TDriver, TContext, TElement, TSelector>>;

package/types/element.d.ts

@@ -39,7 +39,9 @@ export declare class Element<TDriver, TContext, TElement, TSelector> {
     init(context: Context<TDriver, TContext, TElement, TSelector>): Promise<this>;
     getRegion(): Promise<types.Region>;
     getClientRegion(): Promise<types.Region>;
-    getContentSize(): Promise<types.Size>;
+    getContentSize(options?: {
+        lazyLoad?: types.LazyLoadOptions;
+    }): Promise<types.Size>;
     isPager(): Promise<boolean>;
     isScrollable(): Promise<boolean>;
     isRoot(): Promise<boolean>;

package/types/helper-android.d.ts

@@ -12,6 +12,7 @@ export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
     private readonly _input;
     private readonly _action?;
     private readonly _legacy;
+    private readonly _supportAsync;
     private _logger;
     readonly name: 'android' | 'android-legacy';
     constructor(options: {
@@ -20,10 +21,13 @@ export declare class HelperAndroid<TDriver, TContext, TElement, TSelector> {
         action?: Element<TDriver, TContext, TElement, TSelector>;
         legacy: boolean;
         logger?: any;
+        supportAsync?: boolean;
     });
     private _getElementId;
     private _command;
-    getContentRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
+    getContentRegion(element: Element<TDriver, TContext, TElement, TSelector>, options?: {
+        lazyLoad?: types.LazyLoadOptions;
+    }): Promise<types.Region>;
     getTouchPadding(): Promise<number>;
     getRegion(element: Element<TDriver, TContext, TElement, TSelector>): Promise<types.Region>;
     scrollToTop(element: Element<TDriver, TContext, TElement, TSelector>): Promise<void>;