@testim/testim-cli 3.259.0 → 3.260.0

package/commons/testimDesiredCapabilitiesBuilder.js

@@ -41,6 +41,7 @@ const DEFAULT_CHROME_OPTIONS_ARGS = [
     '--mute-audio',
     // Skip first run wizards
     '--no-first-run',
+    '--disable-back-forward-cache',
 ];
 
 const getHash = (...str) => crypto.createHash('sha256').update(str.join('')).digest('hex');
@@ -603,7 +604,10 @@ function buildSeleniumOptions(browserOptions, testName, testRunConfig, gridInfo,
 }
 
 //testRunConfig not in used for now
-function buildAppiumOptions({ projectType, gridInfo, testRunConfig, nativeApp }) {
+function buildAppiumOptions({ projectType, gridInfo, testRunConfig, nativeApp, options }) {
+    const { deviceModel, osVersion, deviceUdid } = options;
+    const headspinSelector = {};
+
     if (!nativeApp) {
         throw Error('missing mobile app!');
     }
@@ -637,6 +641,21 @@ function buildAppiumOptions({ projectType, gridInfo, testRunConfig, nativeApp })
         default:
             throw Error(`unsupported mobile project ${projectType}`);
     }
+    if (deviceModel) {
+        headspinSelector.model = deviceModel;
+    }
+    if (osVersion) {
+        headspinSelector.os_version = osVersion;
+    }
+    if (deviceUdid) {
+        headspinSelector.device_id = deviceUdid;
+        delete headspinSelector.model;
+        delete headspinSelector.os_version;
+    }
+
+    if (!_.isEmpty(headspinSelector)) {
+        appCaps['headspin:selector'] = headspinSelector;
+    }
     return {
         ...connection,
         desiredCapabilities: appCaps,

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@testim/testim-cli",
-  "version": "3.259.0",
+  "version": "3.260.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@testim/testim-cli",
-      "version": "3.259.0",
+      "version": "3.260.0",
       "license": "Proprietary",
       "dependencies": {
         "@applitools/eyes-sdk-core": "13.6.23",
@@ -12773,9 +12773,9 @@
       }
     },
     "node_modules/query-selector-shadow-dom": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/query-selector-shadow-dom/-/query-selector-shadow-dom-1.0.0.tgz",
-      "integrity": "sha512-bK0/0cCI+R8ZmOF1QjT7HupDUYCxbf/9TJgAmSXQxZpftXmTAeil9DRoCnTDkWbvOyZzhcMBwKpptWcdkGFIMg=="
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/query-selector-shadow-dom/-/query-selector-shadow-dom-1.0.1.tgz",
+      "integrity": "sha512-lT5yCqEBgfoMYpf3F2xQRK7zEr1rhIIZuceDK6+xRkJQ4NMbHTwXqk4NkwDwQMNqXgG9r9fyHnzwNVs6zV5KRw=="
     },
     "node_modules/querystring": {
       "version": "0.2.0",
@@ -13026,9 +13026,9 @@
       }
     },
     "node_modules/regenerator-runtime": {
-      "version": "0.13.10",
-      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.10.tgz",
-      "integrity": "sha512-KepLsg4dU12hryUO7bp/axHAKvwGOCV0sGloQtpagJ12ai+ojVDqkeGSiRX1zlq+kjIMZ1t7gpze+26QqtdGqw=="
+      "version": "0.13.11",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
+      "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg=="
     },
     "node_modules/regex-not": {
       "version": "1.0.2",
@@ -26027,9 +26027,9 @@
       "integrity": "sha512-TIRk4aqYLNoJUbd+g2lEdz5kLWIuTMRagAXxl78Q0RiVjAOugHmeKNGdd3cwo/ktpf9aL9epCfFqWDEKysUlLQ=="
     },
     "query-selector-shadow-dom": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/query-selector-shadow-dom/-/query-selector-shadow-dom-1.0.0.tgz",
-      "integrity": "sha512-bK0/0cCI+R8ZmOF1QjT7HupDUYCxbf/9TJgAmSXQxZpftXmTAeil9DRoCnTDkWbvOyZzhcMBwKpptWcdkGFIMg=="
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/query-selector-shadow-dom/-/query-selector-shadow-dom-1.0.1.tgz",
+      "integrity": "sha512-lT5yCqEBgfoMYpf3F2xQRK7zEr1rhIIZuceDK6+xRkJQ4NMbHTwXqk4NkwDwQMNqXgG9r9fyHnzwNVs6zV5KRw=="
     },
     "querystring": {
       "version": "0.2.0",
@@ -26235,9 +26235,9 @@
       }
     },
     "regenerator-runtime": {
-      "version": "0.13.10",
-      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.10.tgz",
-      "integrity": "sha512-KepLsg4dU12hryUO7bp/axHAKvwGOCV0sGloQtpagJ12ai+ojVDqkeGSiRX1zlq+kjIMZ1t7gpze+26QqtdGqw=="
+      "version": "0.13.11",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
+      "integrity": "sha512-kY1AZVr2Ra+t+piVaJ4gxaFaReZVH40AKNo7UCX6W+dEwBo/2oZJzqfuN1qLq1oL45o56cPaTXELwrTh8Fpggg=="
     },
     "regex-not": {
       "version": "1.0.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testim/testim-cli",
-  "version": "3.259.0",
+  "version": "3.260.0",
   "description": "Command line interface for running Testing on your CI",
   "author": "Oren Rubin",
   "contributors": [{
@@ -119,7 +119,8 @@
     "prepare-version": "rm -rf ./deploy && mkdir -p deploy && gulp prepare-version-on-prem",
     "make-onprem-deps": "cp ../../yarn.lock deploy && cd deploy && yarn install --production && bundle-deps",
     "pack-onprem": "yarn prepare-version && yarn make-onprem-deps && cd deploy && npm pack && zip -r testim-cli.zip testim-cli-*.tgz",
-    "pack-serve": "yarn pack-onprem && http-server deploy/"
+    "pack-serve": "yarn pack-onprem && http-server deploy/",
+    "self-test": "cd /tmp && cross-env DEBUG=self-test BUILD_MAX_MEMORY=4096 node /home/circleci/testimio/apps/runner/scripts/selfTest.js"
   },
   "engines": {
     "node": ">= 14.0.0"

package/player/stepActions/baseJsStepAction.js

@@ -45,7 +45,7 @@ class BaseJsStepAction extends StepAction {
 
     executeGetStatus(transactionId) {
         // TODO: Cleanup after dropping IE11/Edge support
-        /* eslint-disable prefer-arrow-callback,  no-undef,  unicorn/prefer-includes */
+        /* eslint-disable prefer-arrow-callback,  no-undef,  unicorn/prefer-includes, no-shadow */
         return this.driver.executeJS(function (transactionId) {
             const sessionItem = 'data-testim-' + transactionId;
             try {
@@ -63,7 +63,7 @@ class BaseJsStepAction extends StepAction {
                 throw err;
             }
         }, transactionId);
-        /* eslint-enable prefer-arrow-callback,  no-undef,  unicorn/prefer-includes */
+        /* eslint-enable prefer-arrow-callback,  no-undef,  unicorn/prefer-includes, no-shadow */
     }
 
     constructJSFunParams(eventData) {

package/player/stepActions/cliConditionStepAction.js

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 const BaseCliJsStepAction = require('./baseCliJsStepAction');
 

package/player/stepActions/cliJsStepAction.js

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 const BaseCliJsStepAction = require('./baseCliJsStepAction');
 

package/player/stepActions/extensionOnlyStepAction.js

@@ -5,7 +5,7 @@ class ExtensionOnlyStepAction extends StepAction {
     performAction() {
         return Promise.resolve({
             success: 'skipped',
-            reason: "This step can run only on Chrome"
+            reason: 'This step can run only on Chrome',
         });
     }
 }

package/player/stepActions/extractTextStepAction.js

@@ -1,10 +1,8 @@
-"use strict";
+'use strict';
 
 const StepAction = require('./stepAction');
-const Promise = require('bluebird');
 
 class ExtractTextStepAction extends StepAction {
-
     performAction() {
         const paramName = this.step.extractTextParamName;
 
@@ -12,13 +10,12 @@ class ExtractTextStepAction extends StepAction {
             .then(extractedText => {
                 this.context.data.exports = this.context.data.exports || {};
                 this.context.data.exports[paramName] = extractedText;
-                return Promise.resolve({
+                return {
                     success: true,
-                    data: this.context.data
-                });
+                    data: this.context.data,
+                };
             });
     }
-
 }
 
 module.exports = ExtractTextStepAction;

package/player/stepActions/hoverStepAction.js

@@ -55,4 +55,3 @@ class HoverStepAction extends StepAction {
 }
 
 module.exports = HoverStepAction;
-

package/player/stepActions/inputFileStepAction.js

@@ -1,7 +1,6 @@
 'use strict';
 
 const StepAction = require('./stepAction');
-const _ = require('lodash');
 const logger = require('../../commons/logger').getLogger('input-file-step-action');
 const { codeSnippets, utils } = require('../../commons/getSessionPlayerRequire');
 const { extractElementId, download } = require('../../utils');

package/player/stepActions/jsCodeStepAction.js

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 const BaseJsStepAction = require('./baseJsStepAction');
 
@@ -9,4 +9,3 @@ class JsCodeStepAction extends BaseJsStepAction {
 }
 
 module.exports = JsCodeStepAction;
-

package/player/stepActions/jsConditionStepAction.js

@@ -1,4 +1,4 @@
-"use strict";
+'use strict';
 
 const BaseJsStepAction = require('./baseJsStepAction');
 
@@ -9,4 +9,3 @@ class JsConditionStepAction extends BaseJsStepAction {
 }
 
 module.exports = JsConditionStepAction;
-

package/player/stepActions/locateStepAction.js

@@ -15,26 +15,26 @@ const {
 const DEFAULT_VISIBILITY_RESULT = { opacity: 1, clientRects: {} };
 
 function createUtils(driver) {
-    return class LocatorUtils {
-        static getFrameIdByTestimFrameId() { }
+    return {
+        getFrameIdByTestimFrameId() { },
 
-        static setElementResultDataOnContext(target) {
+        setElementResultDataOnContext(target) {
             return driver.getElement(target.locatedElement)
                 .then(seleniumResponse => {
                     target.seleniumElement = seleniumResponse.value;
                 });
-        }
+        },
 
-        static getElementRectangle(target) {
+        getElementRectangle(target) {
             return driver.getElementRect(target);
-        }
+        },
 
-        static getOffsets(frameHandler) {
+        getOffsets(frameHandler) {
             return Promise.resolve([frameHandler.frameOffset || {}]);
-        }
+        },
 
         /** @type {typeof import('clickim/src/background/stepActions/locateStepAction').LocateStepAction['htmlStringToDom']} */
-        static htmlStringToDom(htmlString, url, nonBodyElements, bodyTagName, setDomTimeout = true) {
+        htmlStringToDom(htmlString, url, nonBodyElements, bodyTagName, setDomTimeout = true) {
             const virtualConsole = new VirtualConsole();
             const jsdom = new JSDOM(htmlString, {
                 virtualConsole,
@@ -51,9 +51,9 @@ function createUtils(driver) {
             }
             window.document.TESTIM_URL = url;
             return window.document;
-        }
+        },
 
-        static shouldUseNativeVisibilityCheck(locateStep, driver, visibilityUtils, positionUtils) {
+        shouldUseNativeVisibilityCheck(locateStep, driver, visibilityUtils, positionUtils) {
             if (locateStep.opacity === 0) {
                 return false;
             }
@@ -73,10 +73,10 @@ function createUtils(driver) {
                 return featureFlags.flags.useIEWebdriverVisibilityChecks.isEnabled();
             }
             return true;
-        }
+        },
 
         /** @type {typeof import('clickim/src/background/stepActions/locateStepAction').LocateStepAction['isVisible']} */
-        static isVisible(target, targetElement, rect, locateStep, frameHandler, allOffsets, dom) {
+        isVisible(target, targetElement, rect, locateStep, frameHandler, allOffsets, dom) {
             const skipVisibilityCheck =
                 featureFlags.flags.disableEdgeVisibilityChecks.isEnabled() && driver.isEdge();
 
@@ -86,7 +86,7 @@ function createUtils(driver) {
                 return driver.isVisible(target.seleniumElement).catch(() => { }).then(() => true);
             }
 
-            const useNativeVisibilityCheck = LocatorUtils.shouldUseNativeVisibilityCheck(locateStep, driver, visibilityUtils, positionUtils);
+            const useNativeVisibilityCheck = this.shouldUseNativeVisibilityCheck(locateStep, driver, visibilityUtils, positionUtils);
             if (useNativeVisibilityCheck) {
                 return driver.isVisible(target.seleniumElement);
             }
@@ -120,12 +120,12 @@ function createUtils(driver) {
             return driver.isVisible(target.seleniumElement)
                 .catch(() => { })
                 .then(handler);
-        }
+        },
 
-        static scrollToElement(frameHandler, locatedElement) {
+        scrollToElement(frameHandler, locatedElement) {
             const code = codeSnippets.scrollToElement;
             return driver.execute(code(locatedElement));
-        }
+        },
     };
 }
 

package/player/stepActions/pixelValidationStepAction.js

@@ -5,13 +5,12 @@ const StepAction = require('./stepAction');
 const { eyeSdkService } = require('../utils/eyeSdkService');
 const logger = require('../../commons/logger').getLogger('pixel-validation-step-action');
 
-
 class PixelValidationStepAction extends StepAction {
     async performAction() {
         const { shouldUseVisualGrid, applitoolsSdkConfig: config, testResultId } = this.context;
         this.runContext = this.context.getRunContext(undefined);
-        const finalParams = (this.runContext.incomingParams && this.runContext.incomingParams.final) || {};
-        const batchId = (config.batch && config.batch.id) || testResultId;
+        const finalParams = this.runContext.incomingParams?.final || {};
+        const batchId = config.batch?.id || testResultId;
         const eyeManager = await eyeSdkService.getManager(shouldUseVisualGrid, this.context.config.applitoolsConcurrency || 5, batchId, this.runContext.applitoolsIntegrationData);
         const targetElementData = this.getTarget() || {};
         let result;

package/player/stepActions/scrollStepAction.js

@@ -1,16 +1,17 @@
-"use strict";
+'use strict';
+
 const StepAction = require('./stepAction');
 const { codeSnippets, commonConstants } = require('../../commons/getSessionPlayerRequire');
 const scroll = require('./scripts/scroll');
+
 const constants = commonConstants.stepResult;
 
 class ScrollStepAction extends StepAction {
-
-    getFailureString(step, expectedX, expectedY, actualX, actualY){
+    getFailureString(step, expectedX, expectedY, actualX, actualY) {
         if (!step.isScrollToElement) {
             return `Scrolling limit reached. Expected:(y: ${expectedY}, x: ${expectedX}); Actual:(y:${actualY}, x: ${actualX})`;
         }
-        let failureMessage = "Scrolling limit reached";
+        let failureMessage = 'Scrolling limit reached';
         if (step.shouldScrollTop) {
             failureMessage += `. Expected top margin: ${expectedY}, actual: ${actualY}`;
         }
@@ -38,33 +39,41 @@ class ScrollStepAction extends StepAction {
             return scroll.apply(null, arguments)
         `;
 
-        return this.driver.executeJSWithArray(scrollCode, [elementToScrollOn, elementToScrollTo, Boolean(step.isScrollToElement), Boolean(step.isDynamicScroll), expectedX, expectedY, step.shouldScrollLeft, step.shouldScrollTop])
-            .then((res) => {
-                if(!res || !res.value) {
+        return this.driver
+            .executeJSWithArray(scrollCode, [
+                elementToScrollOn,
+                elementToScrollTo,
+                Boolean(step.isScrollToElement),
+                Boolean(step.isDynamicScroll),
+                expectedX,
+                expectedY,
+                step.shouldScrollLeft,
+                step.shouldScrollTop,
+            ])
+            .then(res => {
+                if (!res || !res.value) {
                     return {
                         errorType: constants.SCROLL_ACTION_FAILURE,
                         success: false,
-                    }
+                    };
                 }
 
-                const {success, actualX, actualY} = res.value;
+                const { success, actualX, actualY } = res.value;
 
-                if(success) {
-                    return {success: true};
+                if (success) {
+                    return { success: true };
                 }
 
                 return {
                     errorType: constants.SCROLL_ACTION_FAILURE,
                     success: false,
-                    resultInfo: {error: this.getFailureString(step, expectedX, expectedY, actualX, actualY)}
+                    resultInfo: { error: this.getFailureString(step, expectedX, expectedY, actualX, actualY) },
                 };
             })
-            .catch(() => {
-                return {
-                    errorType: constants.SCROLL_ACTION_FAILURE,
-                    success: false,
-                };
-            });
+            .catch(() => ({
+                errorType: constants.SCROLL_ACTION_FAILURE,
+                success: false,
+            }));
     }
 
     scrollOnDocument(step, elementToScrollTo) {
@@ -84,7 +93,6 @@ class ScrollStepAction extends StepAction {
             this.scrollOnDocument(step, elementToScrollTo) :
             this.scrollOnElement(step, elementToScrollTo);
     }
-
 }
 
 module.exports = ScrollStepAction;

package/player/stepActions/selectOptionStepAction.js

@@ -15,7 +15,7 @@ class SelectOptionStepAction extends StepAction {
 
         const browserMajor = browserAndOS.browserMajor;
         const isSafari = this.driver.isSafari();
-        const isShadowed = Boolean(this.step.element && this.step.element.isShadowed);
+        const isShadowed = Boolean(this.step.element?.isShadowed);
 
         // TODO: Remove the special handling for safari < 12 after we upgrade our grid to safari 13.
         // force use js code when element is shadow dom
@@ -40,7 +40,7 @@ class SelectOptionStepAction extends StepAction {
         `;
 
         const result = await this.driver.executeJSWithArray(selectOptionCode, [locatedElement, safariSelectOptionDispatchEventOnSelectElement]);
-        if (result.value && result.value.success) {
+        if (result.value?.success) {
             return { success: true };
         }
         return { success: false };

package/player/stepActions/specialKeyStepAction.js

@@ -1,11 +1,12 @@
-"use strict";
+'use strict';
 
 const { extractElementId } = require('../../utils');
 const StepAction = require('./stepAction');
 const Promise = require('bluebird');
+
 const keyMap = {
-    8: '\uE008',  // (Backspace)
-    9: '\uE004',  // (tab)
+    8: '\uE008', // (Backspace)
+    9: '\uE004', // (tab)
     13: '\uE007', // (enter)
     27: '\uE00C', // (esc)
     33:	'\uE00E', // (page up)
@@ -24,23 +25,22 @@ const keyMap = {
     120: '\uE039', // (f9)
     121: '\uE03A', // (f10)
     122: '\uE03B', // (f11)
-    123: '\uE03C' // (f12)
+    123: '\uE03C', // (f12)
 };
 
 class SpecialKeyStepAction extends StepAction {
-
     setWithValueApi(keys) {
         const target = this.getTarget();
-        if (target && target.seleniumElement) {
+        if (target?.seleniumElement) {
             return this.driver.elementIdValue(extractElementId(target.seleniumElement), keys);
         }
-        return Promise.reject(new Error("missing selenium element"));
+        return Promise.reject(new Error('missing selenium element'));
     }
 
     performAction() {
         const keys = [];
         const keyCode = this.step.events[0].eventData.keyCode;
-        
+
         if (keyCode >= 32 && keyCode <= 127) {
             keys.push(String.fromCharCode(keyCode));
         } else {
@@ -48,8 +48,6 @@ class SpecialKeyStepAction extends StepAction {
         }
         return this.setWithValueApi(keys);
     }
-
 }
 
 module.exports = SpecialKeyStepAction;
-

package/player/stepActions/stepAction.js

@@ -45,11 +45,11 @@ class StepAction {
     /** @type {ClickimStepAction['execute']} */
     execute(stepActionFactory, step) {
         return Promise.resolve(this.performAction(stepActionFactory, step))
-            .then(res => Promise.resolve(Object.assign({}, { success: true }, res)))
+            .then(res => Object.assign({ success: true }, res))
             .catch(err => {
-                const errorMsg = (err || {}).message || (err && err.seleniumStack && err.seleniumStack.message);
-                const displayMsg = (err || {}).displayMessage;
-                return Promise.resolve({
+                const errorMsg = err?.message || err?.seleniumStack?.message;
+                const displayMsg = err?.displayMessage;
+                return {
                     success: false,
                     reason: errorMsg,
                     exception: err,
@@ -60,7 +60,7 @@ class StepAction {
                         // expects resultInfo.error or resultInfo.reason
                         error: displayMsg || errorMsg,
                     },
-                });
+                };
             });
     }
 }

package/player/stepActions/stepActionRegistrar.js

@@ -104,4 +104,3 @@ module.exports = function (driver, stepActionFactory, runMode) {
         stepActionFactory.registerLocateStepActionUtils(LocateStepAction.getUtils(driver));
     }
 };
-

package/player/stepActions/submitStepAction.js

@@ -1,9 +1,8 @@
-"use strict";
+'use strict';
 
 const StepAction = require('./stepAction');
 
 class SubmitStepAction extends StepAction {
-
     performAction() {
         return this.driver.submitForm(this.getTarget().seleniumElement)
             .then(() => {});

package/player/stepActions/tdkHybridStepAction.js

@@ -1,18 +1,16 @@
 'use strict';
 
 const StepAction = require('./stepAction');
-
-const { execute } = require('../../stepPlayers/hybridStepPlayback')
+const { execute } = require('../../stepPlayers/hybridStepPlayback');
 
 class TdkHybridStepAction extends StepAction {
-
     async performAction() {
-       return await execute(
-           this.step,
-           this.context,
-           this.driver,
-           this.stepActionUtils.testimServicesApi.authenticationManager.getLoggedUserInfo(),
-           this.frameHandler.frameManager
+        return await execute(
+            this.step,
+            this.context,
+            this.driver,
+            this.stepActionUtils.testimServicesApi.authenticationManager.getLoggedUserInfo(),
+            this.frameHandler.frameManager
         );
     }
 }

package/player/stepActions/textStepAction.js

@@ -10,6 +10,7 @@ const { extractElementId, delay } = require('../../utils');
 
 const constants = sessionPlayer.commonConstants.stepResult;
 const setTextDraftJs = codeSnippets?.setTextDraftJs;
+
 class TextStepAction extends StepAction {
     setValueNative() {
         const context = this.context;

package/player/stepActions/textValidationStepAction.js

@@ -1,27 +1,24 @@
-"use strict";
-
+'use strict';
 
+const Promise = require('bluebird');
 const sessionPlayer = require('../../commons/getSessionPlayerRequire');
-
 const StepAction = require('./stepAction');
+
 const constants = sessionPlayer.commonConstants.stepResult;
 const paramEvaluator = sessionPlayer.stepParamExpressionEvaluator;
 const utils = sessionPlayer.utils;
 
-
-const Promise = require('bluebird');
-
 class TextValidationStepAction extends StepAction {
     performAction(stepActionFactory) {
-        var step = this.step;
-        var context = this.context;
-        var target = this.getTarget();
-        var frameHandler = this.frameHandler;
-        
+        const step = this.step;
+        const context = this.context;
+        const target = this.getTarget();
+        const frameHandler = this.frameHandler;
+
 
         return new Promise(resolve => {
-            var onFail = resultInfo => {
-                resolve({ errorType: constants.TEXT_COMPARE_FAILURE, resultInfo: resultInfo, success: false });
+            const onFail = resultInfo => {
+                resolve({ errorType: constants.TEXT_COMPARE_FAILURE, resultInfo, success: false });
             };
             this.stepActionUtils.extractTargetText(target)
                 .then(text => {
@@ -29,13 +26,13 @@ class TextValidationStepAction extends StepAction {
                         const expected = paramEvaluator.computeExpression(step.expression2, context, this.exportsGlobal, this.exportsTest);
                         return {
                             actual: text,
-                            expected: expected.evaluatedText
+                            expected: expected.evaluatedText,
                         };
                     }
                     return stepActionFactory.executeStep(step.expression2, context, frameHandler, this.exportsGlobal, this.locateElementPlayer, this.exportsTest)
                         .then(res => ({
                             actual: text,
-                            expected: res.evaluatedText
+                            expected: res.evaluatedText,
                         }));
                 })
                 .then(({ actual, expected }) => {
@@ -43,16 +40,16 @@ class TextValidationStepAction extends StepAction {
                         const compareResult = utils.compareOrMatch(expected, actual);
                         return compareResult ?
                             resolve({ success: true }) :
-                            onFail({ expected: String(expected), actual: actual });
+                            onFail({ expected: String(expected), actual });
                     } catch (err) {
-                        return onFail({ expected: expected.toString(), actual: actual });
+                        return onFail({ expected: expected.toString(), actual });
                     }
                 })
                 .catch(err => resolve({
                     success: false,
                     reason: err.message,
                     exception: err,
-                    shouldRetry: true
+                    shouldRetry: true,
                 }));
         });
     }

package/player/stepActions/wheelStepAction.js

@@ -1,11 +1,11 @@
-"use strict";
+'use strict';
+
 const Promise = require('bluebird');
 const StepAction = require('./stepAction');
 const wheelScript = require('./scripts/wheel');
 const { codeSnippets } = require('../../commons/getSessionPlayerRequire');
 
 class WheelStepAction extends StepAction {
-
     performAction() {
         const step = this.step;
         const context = this.context;
@@ -16,12 +16,12 @@ class WheelStepAction extends StepAction {
         }
 
         const eventMessage = {
-            events: events,
+            events,
             eventData: {
                 modifiers: step.modifiers,
-                button: step.button
+                button: step.button,
             },
-            locatedElement: this.getTarget().locatedElement
+            locatedElement: this.getTarget().locatedElement,
         };
 
         const timeout = context.data.timeToPlayStep + 3000;
@@ -29,7 +29,7 @@ class WheelStepAction extends StepAction {
         const wheelCode = `
             var getLocatedElement = ${codeSnippets.getLocatedElementCode};
             var wheel = ${wheelScript.toString()};
-            var eventData = ${this.driver.isEdge() ? `JSON.parse(arguments[0])` : `arguments[0]`};
+            var eventData = ${this.driver.isEdge() ? 'JSON.parse(arguments[0])' : 'arguments[0]'};
             var done = arguments[1];
             return wheel.call(null, eventData, done);
         `;
@@ -40,13 +40,12 @@ class WheelStepAction extends StepAction {
 
         return this.driver.executeCodeAsync(wheelCode, timeout, eventParam)
             .then(result => {
-                if (result.value && result.value.state === "success") {
-                    return Promise.resolve({ success: true });
+                if (result.value && result.value.state === 'success') {
+                    return { success: true };
                 }
-                return Promise.resolve({ success: false });
+                return { success: false };
             });
     }
-
 }
 
 module.exports = WheelStepAction;

package/runOptions.d.ts

@@ -108,6 +108,13 @@ interface RunnerOptions extends Partial<Omit<TunnelOptions, 'tunnelOnlyMode' | '
     retentionDays?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
     retries?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20;
 
+    //# region mobile flags
+    deviceModel: string;
+    deviceUdid: string;
+    osVersion: string;
+    // #endregion
+
+
     // #region Data set based on values from server
     company: {
         companyId: string;

package/runOptions.js

@@ -210,6 +210,10 @@ program
     .option('--set-retention [retention-in-days]', 'set the number of days for results retention')
     .option('--user [user-id]', 'user ID for local Testim-CLI')
     .option('--pass-zero-tests', 'don\'t fail the run if no tests were found')
+    //Mobile options
+    .option('--device-model [device-model]', 'The device model	to use, iPhone 12, Nexus 5X, SM-G900P etc....')
+    .option('--device-udid [device-udid]', 'the device unique  id')
+    .option('--os-version [os-version]', 'The operating system version number')
 
     .option('-str --suppress-tms-reporting [suppress-tms-reporting]', 'disable test management reporting', false)
     .option('-tsr --tms-suppress-reporting [tms-suppress-reporting]', 'disable test management reporting', false)
@@ -1032,6 +1036,10 @@ module.exports = {
             program.turboMode = true;
         }
 
+        if (program.deviceUdid && (program.deviceModel || program.osVersion)) {
+            throw new ArgError('It is not possible to use --osVersion or  --deviceModel with  --device-udid. device-udid is unique and cannot be combined with another flag');
+        }
+
         if (program.lightweightMode) {
             try {
                 const DEFAULTS = {
@@ -1148,6 +1156,10 @@ module.exports = {
             passZeroTests: Boolean(program.passZeroTests),
             runQuarantinedTests: Boolean(program.runQuarantinedTests),
 
+            deviceModel: program.deviceModel,
+            deviceUdid: program.deviceUdid,
+            osVersion: program.osVersion,
+
             // Extension
             ext: program.ext,
             extensionLocation: [program.extensionPath || extHeadlessUrl].flat(),

package/runOptionsUtils.js

@@ -1,20 +1,21 @@
 // @ts-check
 
-"use strict";
+'use strict';
+
 const config = require('./commons/config');
 
 module.exports = {
     getExtensionsUrl,
     getResolvedExtensionUrl,
-    getPlayerUrl
-}
+    getPlayerUrl,
+};
 
 /**
  *
  * @param {Readonly<import("commander").CommanderStatic>} program
  */
 function getExtensionsUrl(program, useCanonicalURL) {
-    const zipFileSuffix = program.canary ? "-master.zip" : ".zip";
+    const zipFileSuffix = program.canary ? '-master.zip' : '.zip';
     let firefox;
     let chrome;
     if (!useCanonicalURL) {
@@ -40,11 +41,11 @@ function getResolvedExtensionUrl(program) {
 
     if (program.browser === 'firefox') {
         return firefox;
-    } else if(program.browser === 'chrome') {
-        return chrome
-    } else {
-        return [chrome, firefox];
     }
+    if (program.browser === 'chrome') {
+        return chrome;
+    }
+    return [chrome, firefox];
 }
 
 /**
@@ -52,8 +53,8 @@ function getResolvedExtensionUrl(program) {
  * @param {Readonly<import("commander").CommanderStatic>} program
  */
 function getPlayerUrl(program) {
-    let playerUrlPrefix = `${config.BLOB_URL}/extension/sessionPlayer`;
-    const playerUrl = program.canary ? playerUrlPrefix + "-master" : playerUrlPrefix;
+    const playerUrlPrefix = `${config.BLOB_URL}/extension/sessionPlayer`;
+    const playerUrl = program.canary ? `${playerUrlPrefix}-master` : playerUrlPrefix;
 
     return playerUrl;
 }

package/workers/WorkerAppium.js

@@ -30,7 +30,7 @@ class WorkerAppium extends BaseWorker {
         const { driver } = appiumTestPlayer;
         const nativeApp = testRunHandler.getNativeAppData();
         const projectType = this.options.projectData.type;
-        const capabilities = desiredCapabilitiesBuilder.buildAppiumOptions({ projectType, gridInfo, testRunConfig: this.testRunConfig, nativeApp });
+        const capabilities = desiredCapabilitiesBuilder.buildAppiumOptions({ projectType, gridInfo, testRunConfig: this.testRunConfig, nativeApp, options: this.options });
         try {
             //we assume the application is installed on the device. (all headspin allocated devices)
             const activeSession = await driver.remote(capabilities);