@sap_oss/wdio-qmate-service 2.13.1 → 2.13.2

package/lib/reuse/modules/mobile/device.js

@@ -4,8 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Device = void 0;
+// Imports
 const verboseLogger_1 = require("../../helper/verboseLogger");
 const errorHandler_1 = __importDefault(require("../../helper/errorHandler"));
+const ORIENTATION = {
+    LANDSCAPE: "LANDSCAPE",
+    PORTRAIT: "PORTRAIT",
+    UNKNOWN: "UNKNOWN"
+};
 /**
  * @class device
  * @memberof mobile
@@ -15,47 +21,395 @@ class Device {
         this.vlf = new verboseLogger_1.VerboseLoggerFactory("mobile", "device");
         this.ErrorHandler = new errorHandler_1.default();
     }
+    //==================================Private Methods===============================================
+    /**
+     * @function isValidPlatform
+     * @memberof mobile.device
+     * @description Check the mobile platform from the session's capabilities.
+     * @returns {boolean} Returns 'true' if the platform in the session's capabilities is either Android or iOS.
+     */
+    async isValidPlatform() {
+        const vl = this.vlf.initLog(this.isValidPlatform);
+        const SUPPORTED_PLATFORMS = ["android", "ios"];
+        const platform = await browser.capabilities.platformName;
+        return SUPPORTED_PLATFORMS.includes(platform.toLowerCase().trim());
+    }
+    /**
+     * @function executionPlatform
+     * @memberof mobile.device
+     * @description Check the mobile platform from the session's capabilities.
+     * @returns {string} Return current execution platform in the session's capabilities.
+     */
+    async executionPlatform() {
+        const vl = this.vlf.initLog(this.executionPlatform);
+        const platform = browser.capabilities.platformName;
+        return platform.toLowerCase().trim();
+    }
+    //==================================Public Methods================================================
     /**
      * @function isAppInstalled
      * @memberof mobile.device
      * @description Check wether given package/bundle app is installed or not in the device.
-     * @param {string} packageIdOrBundleId - Android package Id, or iOS bundle Id.
-     * @returns {boolean} Returns true if specified app package/bundled installed in the device, or false.
-     * @example await mobile.device.isAppInstalled("com.google.android.apps.maps");
+     * @param {string} appPackageOrBundleId - Android package Id, or iOS bundle Id.
+     * @returns {boolean} Returns 'true' if specified app package/bundled installed in the device, or 'false'.
+     * @example
+     * await mobile.device.isAppInstalled("com.google.android.apps.maps");
+     * await mobile.device.isAppInstalled("com.apple.AppStore")
      */
-    async isAppInstalled(packageIdOrBundleId) {
+    async isAppInstalled(appPackageOrBundleId) {
         const vl = this.vlf.initLog(this.isAppInstalled);
+        let isAppInstalledInDevice = false;
         try {
-            const isAppInstalledInDevice = browser.isAppInstalled(packageIdOrBundleId);
-            vl.log(`Given app package/bundle id ${packageIdOrBundleId} installed on the device is ${isAppInstalledInDevice.toString()}`);
-            return isAppInstalledInDevice;
+            if (await this.isValidPlatform()) {
+                isAppInstalledInDevice = browser.isAppInstalled(appPackageOrBundleId);
+                vl.log(`${await this.executionPlatform()} app installed successfully.`);
+            }
+            else {
+                vl.log(`Unsupported platform while checking the is app installed or not`);
+            }
         }
         catch (error) {
-            return this.ErrorHandler.logException(error, "Error: During isAppInstalled", true);
+            this.ErrorHandler.logException(error, "Error: Could not determine if app is installed, The provided package name is invalid.", true);
         }
+        return isAppInstalledInDevice;
     }
     /**
      * @function installApp
      * @memberof mobile.device
      * @description Install the appropriate app based on the platform the test is being executed on.
      * @param {string} appPath - Path of the app(.apk, .ipa)
+     * @returns {Promise<void>}
      * @example
      * await mobile.device.installApp("/path/to/your/app.apk");
      * await mobile.device.installApp("/path/to/your/app.ipa");
      */
     async installApp(appPath) {
         const vl = this.vlf.initLog(this.installApp);
-        const platform = await browser.capabilities.platformName;
         try {
-            vl.log(`Installing ${platform.toLowerCase()} app...`);
-            if (["android", "ios"].includes(platform.toLowerCase().trim())) {
+            vl.log(`Installing ${await this.executionPlatform()} app...`);
+            if (await this.isValidPlatform()) {
                 await browser.installApp(appPath);
-                vl.log(`${platform.toLowerCase()} app installed successfully.`);
+                vl.log(`${await this.executionPlatform()} app installed successfully.`);
+            }
+            else {
+                vl.log(`Unsupported platform ${await this.executionPlatform()} while installing app`);
+            }
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Unable to install app. The provided app path ${appPath} does not exist`, true);
+        }
+    }
+    /**
+     * @function switchToContext
+     * @memberof mobile.device
+     * @description Switch to the specified( WEBVIEW | NATIVE_APP ) context if available.
+     * @param {string} [targetContext='WEBVIEW'] The name of the target context.
+     * @param {number} [timeout=5000] Maximum time to wait for the web context to appear, milliseconds.
+     * @returns {Promise<boolean>} Returns 'true' if the context is successfully switched, otherwise 'false'.
+     * @example
+     * await mobile.device.switchToContext();
+     * await mobile.device.switchToContext("NATIVE_APP", 1000);
+     */
+    async switchToContext(targetContext = "WEBVIEW", timeout = 5000) {
+        const vl = this.vlf.initLog(this.switchToContext);
+        try {
+            let target = this.getTargetContextIfAvailable(targetContext, timeout);
+            if (target) {
+                await browser.switchContext(target);
+                vl.log(`Switched to ${target} context successfully...`);
+                return true;
+            }
+            else {
+                vl.log(`Switched to ${target} context not successful, it may be null`);
+            }
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: No contexts available, Could not switch to ${targetContext} context 'INVALID_CONTEXT'. `, true);
+        }
+        return false;
+    }
+    /**
+     * @function getTargetContextIfAvailable
+     * @memberof mobile.device
+     * @description
+     * Returns the specified target context if available within a given timeout.
+     *
+     * This method retrieves the list of available contexts and determines if a context
+     * that matches the `targetContext` string is present. If the target context is found,
+     * it returns the context name; otherwise, it returns `null`.
+     *
+     * @param {string} [targetContext="WEBVIEW"] - The name of the target context to check for.
+     *   Common examples are "WEBVIEW" or "NATIVE_APP".
+     * @param {number} [timeout=5000] - The maximum time, in milliseconds, to wait for the target
+     *   context to become available.
+     * @returns {Promise<string | null>} - The name of the target context if found, or `null` if
+     *   the context is not available within the timeout.
+     * @example
+     * const context = await getTargetContextIfAvailable("WEBVIEW", 10000);
+     * const context = await getTargetContextIfAvailable("NATIVE_APP", 10000);
+     */
+    async getTargetContextIfAvailable(targetContext = "WEBVIEW", timeout = 5000) {
+        const vl = this.vlf.initLog(this.getTargetContextIfAvailable);
+        try {
+            let availableContexts = [];
+            const isContextAvailable = await browser.waitUntil(async () => {
+                // Get all available contexts
+                availableContexts = await browser.getContexts();
+                return availableContexts.some((context) => context.includes(targetContext));
+            }, {
+                timeout,
+                timeoutMsg: `Target Context "${targetContext}" not found within ${timeout}ms`
+            });
+            if (isContextAvailable) {
+                const target = availableContexts.find((context) => context.includes(targetContext));
+                vl.log(`Target Context "${target}" is available.`);
+                return target || null;
+            }
+            else {
+                vl.log(`Target Context ${targetContext} is not available.`);
+            }
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: No contexts available, Failed to check is target ${targetContext} context available`, true);
+        }
+        return null;
+    }
+    /**
+     * @function closeApplication
+     * @memberof mobile.device
+     * @description Close the currently active mobile application.
+     * @returns {Promise<void>}
+     * @example
+     * await mobile.device.closeApplication();
+     */
+    async closeApplication() {
+        const vl = this.vlf.initLog(this.closeApplication);
+        try {
+            await browser.closeApp();
+            vl.log("The application has been closed successfully.");
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Unable to close app, the app is not currently running`, true);
+        }
+    }
+    /**
+     * @function queryAppState
+     * @memberof mobile.device
+     * @description Queries the state of the application (e.g., running, background, not installed) on the mobile device(Android or iOS).
+     * @param {string} appPackageOrBundleId - Package name (Android) or bundle ID (iOS) of the application.
+     * @returns {Promise<number>} - The app state:
+     *  0 - Not running,
+     *  1 - Not installed,
+     *  2 - Running in the background (not suspended),
+     *  3 - Running in the background (suspended),
+     *  4 - Running in the foreground.
+     * @example
+     * await mobile.device.queryAppState("com.google.android.apps.maps");
+     * await mobile.device.queryAppState("com.apple.AppStore");
+     */
+    async queryAppState(appPackageOrBundleId) {
+        const vl = this.vlf.initLog(this.queryAppState);
+        let appState = -1;
+        try {
+            vl.log(`Querying the ${await this.executionPlatform()} app state...`);
+            if (await this.isValidPlatform()) {
+                appState = await browser.queryAppState(appPackageOrBundleId);
+                vl.log(`Application state for ${appPackageOrBundleId} : ${appState}`);
+            }
+            else {
+                vl.log(`Unsupported platform while query app state: ${await this.executionPlatform()}`);
+            }
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Unable to query app state, the package name ${appPackageOrBundleId} is invalid or does not exist.`, true);
+        }
+        return appState;
+    }
+    /**
+     * @function launchApp
+     * @memberof mobile.device
+     * @description Launches the app for both iOS and Android with a parameterized app identifier.
+     * @param {string} appPackageOrBundleId - The Android package name or iOS bundle ID of the application.
+     * @returns {Promise<void>} Resolves when the app is successfully launched.
+     * @example
+     * await mobile.device.launchApp("com.google.android.apps.maps");
+     * await mobile.device.launchApp("com.apple.AppStore");
+     */
+    async launchApp(appPackageOrBundleId) {
+        const vl = this.vlf.initLog(this.launchApp);
+        try {
+            vl.log(`Launching ${await this.executionPlatform()} app...`);
+            if (await this.isValidPlatform()) {
+                await browser.activateApp(appPackageOrBundleId);
+                vl.log(`${await this.executionPlatform()} App launched successfully with given ${appPackageOrBundleId} Package/bundle ID`);
+            }
+            else {
+                vl.log(`Unsupported platform while launching the app: ${await this.executionPlatform()}`);
             }
         }
         catch (error) {
-            this.ErrorHandler.logException(error, `Error: Unsupported platform while installing the app: ${platform.toLowerCase().trim()}`, true);
+            this.ErrorHandler.logException(error, `Error: Unable to launch the app, the package name ${appPackageOrBundleId} is invalid or does not exist.`, true);
+        }
+    }
+    /**
+     * @function switchToLandscapeOrientation
+     * @memberof mobile.device
+     * @description Switches the device orientation to landscape mode.
+     * @returns {Promise<void>} Resolves when the orientation is successfully switched.
+     * @example
+     * await mobile.device.switchToLandscapeOrientation();
+     */
+    async switchToLandscapeOrientation() {
+        const vl = this.vlf.initLog(this.switchToLandscapeOrientation);
+        try {
+            const currentOrientation = await browser.getOrientation();
+            if (currentOrientation === ORIENTATION.LANDSCAPE) {
+                vl.log("Device is already in landscape mode.");
+                return;
+            }
+            vl.log("Switching device orientation to landscape...");
+            await browser.setOrientation(ORIENTATION.LANDSCAPE);
+            vl.log("Device orientation successfully switched to landscape.");
         }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Could not change device orientation, Invalid argument: The orientation must be 'LANDSCAPE'.`, true);
+        }
+    }
+    /**
+     * @function switchToPortraitOrientation
+     * @memberof mobile.device
+     * @description Switches the device orientation to portrait mode.
+     * @returns {Promise<void>} Resolves when the orientation is successfully switched.
+     * @example
+     * await mobile.device.switchToPortraitOrientation();
+     */
+    async switchToPortraitOrientation() {
+        const vl = this.vlf.initLog(this.switchToPortraitOrientation);
+        try {
+            const currentOrientation = await browser.getOrientation();
+            if (currentOrientation === ORIENTATION.PORTRAIT) {
+                vl.log("Device is already in portrait mode.");
+                return;
+            }
+            vl.log("Switching device orientation to portrait...");
+            await browser.setOrientation(ORIENTATION.PORTRAIT);
+            vl.log("Device orientation successfully switched to portrait.");
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Could not change device orientation, Invalid argument: The orientation must be 'PORTRAIT`, true);
+        }
+    }
+    /**
+     * @function getCurrentOrientation
+     * @memberof mobile.device
+     * @description Returns the device current orientation (PORTRAIT or LANDSCAPE)
+     * @returns {Promise<Orientation>} The current device orientation.
+     * @example
+     * await mobile.device.getCurrentOrientation();
+     */
+    async getCurrentOrientation() {
+        const vl = this.vlf.initLog(this.getCurrentOrientation);
+        let orientation = ORIENTATION.UNKNOWN; // Default value
+        try {
+            orientation = await browser.getOrientation();
+            vl.log(`Current device orientation: ${orientation}`);
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Could not get the current device orientation`, true);
+        }
+        return orientation;
+    }
+    /**
+     * @function hideKeyboard
+     * @memberof mobile.device
+     * @description Hides the keyboard on both Android and iOS using specific strategies with timeout.
+     * @param {string} strategy - Strategy to use for hiding the keyboard ('pressKey', 'tapOutside', 'swipeDown').
+     * @param {string} key - Key to press if using the 'pressKey' strategy (e.g., 'Done', 'Enter').
+     * @param {number} keyCode - Key code for Android (optional).
+     * @param {number} [timeout=5000] - Timeout in milliseconds for retrying to hide the keyboard.
+     * @returns {Promise<void>}
+     * @example
+     * await mobile.device.hideKeyboard();
+     * await mobile.device.hideKeyboard('tapOutside');
+     * await mobile.device.hideKeyboard('swipeDown');
+     * //Android only, Sends a specific key code, like 66 for "Enter."
+     * await mobile.device.hideKeyboard('pressKey', undefined, 66);
+     * await mobile.device.hideKeyboard('pressKey', 'Done');
+     */
+    async hideKeyboard(strategy, key, keyCode, timeout = 5000) {
+        const vl = this.vlf.initLog(this.hideKeyboard);
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            try {
+                if (await util.browser.isAndroid()) {
+                    vl.log("Hiding keyboard on Android.");
+                    await browser.hideKeyboard(strategy, key, keyCode);
+                }
+                else if (await util.browser.isIos()) {
+                    vl.log("Hiding keyboard on iOS.");
+                    await browser.execute("mobile: hideKeyboard", { strategy });
+                }
+                else {
+                    vl.log("Unsupported platform: Unable to hide the keyboard.");
+                    return;
+                }
+                vl.log("Keyboard hidden successfully.");
+                return; // Exit if the keyboard is successfully hidden
+            }
+            catch (error) {
+                // Wait briefly before retrying
+                await new Promise((resolve) => setTimeout(resolve, 500));
+                this.ErrorHandler.logException(error, `Error: Failed to hide the keyboard, Retrying...`, true);
+            }
+        }
+        vl.log(`Failed to hide the keyboard within the timeout of ${timeout}ms.`);
+    }
+    /**
+     * @function isKeyboardVisible
+     * @memberof mobile.device
+     * @description Checks if the keyboard is visible or not on the mobile device.
+     * @returns {Promise<boolean>} Returns 'true' if the keyboard is visible on the mobile view.
+     * @example
+     * await mobile.device.isKeyboardVisible();
+     */
+    async isKeyboardVisible() {
+        const vl = this.vlf.initLog(this.isKeyboardVisible);
+        let isKeyboardVisible = false;
+        try {
+            if (await util.browser.isAndroid()) {
+                vl.log("check if the screen height is reduced due to the keyboard");
+                // For Android, check if the screen height is reduced due to the keyboard
+                const windowRect = await browser.getWindowRect();
+                const screenSize = await browser.getWindowSize();
+                // If the visible height is less, keyboard is visible
+                vl.log("if visible height is less, keyboard is visible");
+                isKeyboardVisible = windowRect.height < screenSize.height;
+            }
+            else if (await util.browser.isIos()) {
+                // For iOS, check if the keyboard is displayed via Appium's mobile API
+                const isKeyboardShown = await browser.execute("mobile: isKeyboardShown");
+                isKeyboardVisible = isKeyboardShown === true; // Returns true if the keyboard is visible
+            }
+            else {
+                vl.log("Unsupported platform: Unable to detect keyboard visibility.");
+                return false;
+            }
+        }
+        catch (error) {
+            this.ErrorHandler.logException(error, `Error: Failed to get the is keyboard visible`, true);
+        }
+        return isKeyboardVisible;
+    }
+    /**
+     * @function isPlatformSupported
+     * @memberof mobile.device
+     * @description Determine if the current platform is supported, if the current device platform is either Android or iOS.
+     * @returns {Promise<boolean>} If neither Android nor iOS is detected (e.g., Windows, Linux, or web), the condition evaluates to false
+     * @example
+     * await mobile.device.isPlatformSupported();
+     */
+    async isPlatformSupported() {
+        return (await util.browser.isAndroid()) || (await util.browser.isIos());
     }
 }
 exports.Device = Device;

package/lib/reuse/modules/mobile/device.js.map

@@ -1 +1 @@
-{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../../src/reuse/modules/mobile/device.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;AACb,8DAAkE;AAClE,6EAAqD;AAErD;;;GAGG;AACH,MAAa,MAAM;IAAnB;QACU,QAAG,GAAG,IAAI,oCAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnD,iBAAY,GAAG,IAAI,sBAAY,EAAE,CAAC;IA2C5C,CAAC;IAzCC;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAAC,mBAA2B;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,sBAAsB,GAAY,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;YACpF,EAAE,CAAC,GAAG,CAAC,+BAA+B,mBAAmB,+BAA+B,sBAAsB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7H,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,EAAE,8BAA8B,EAAE,IAAI,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAW,MAAM,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;QACjE,IAAI,CAAC;YACH,EAAE,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YACtD,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/D,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClC,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,EAAE,yDAAyD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACxI,CAAC;IACH,CAAC;CACF;AA7CD,wBA6CC;AACD,kBAAe,IAAI,MAAM,EAAE,CAAC"}
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../../src/reuse/modules/mobile/device.ts"],"names":[],"mappings":"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"}

package/lib/reuse/modules/mobile/element.d.ts

@@ -10,11 +10,11 @@ export declare class ElementModule {
      * @function isVisible
      * @memberof mobile.element
      * @description Returns a boolean if the mobile element is visible to the user.
-     * @param {Object} element - The Mobile Ui element.
-     * @param {Boolean} [strict=true] - If strict mode is enabled it will only return "true" if the element is visible on the mobile view and within the viewport.
+     * @param {Element} element - The Mobile Ui element.
+     * @param {boolean} [strict=true] - If strict mode is enabled it will only return "true" if the element is visible on the mobile view and within the viewport.
      * If "false", it will be sufficient if the element is visible on the view but not inside the current viewport.
-     * @returns {Boolean} Returns true or false.
-     * @example const elem = await mobile.element.isVisible("button01");
+     * @returns {boolean} Returns true or false.
+     * @example
      * await mobile.element.isVisible(elem);
      */
     isVisible(element: Element, strict?: boolean): Promise<boolean>;
@@ -22,8 +22,8 @@ export declare class ElementModule {
      * @function isPresent
      * @memberof mobile.element
      * @description Returns a boolean if the element is present at the DOM or not. It might be hidden.
-     * @param {Object} elem - The element.
-     * @returns {Boolean} Returns true or false.
+     * @param {Element} element - The element.
+     * @returns {boolean} Returns true or false.
      * @example
      * await mobile.element.isPresent(elem);
      */
@@ -33,44 +33,63 @@ export declare class ElementModule {
      * @memberof mobile.element
      * @description Waits until the element with the given selector is present.
      * @param {Object} selector - The CSS selector describing the element.
-     * @param {Number} [timeout=30000] - The timeout to wait (ms).
-     * @example await mobile.element.waitToBePresent(".input01");
-     * @example await mobile.element.waitToBePresent("#button12");
-     * @example await mobile.element.waitToBePresent("p:first-child");
+     * @param {number} [timeout = 30000] - The timeout to wait (ms).
+     * @returns {boolean} Returns true or false.
+     * @example
+     * await mobile.element.waitToBePresent(".input01");
+     * await mobile.element.waitToBePresent("#button12");
+     * await mobile.element.waitToBePresent("p:first-child");
      */
-    waitToBePresent(selector: any, timeout?: number): Promise<void>;
+    waitToBePresent(selector: any, timeout?: number): Promise<boolean>;
     /**
      * @function waitToBeVisible
      * @memberof mobile.element
      * @description Waits until the element with the given selector is visible.
      * @param {Object} selector - The CSS selector describing the element.
-     * @param {Number} [timeout=30000] - The timeout to wait (ms).
-     * @example await mobile.element.waitToBeVisible(".input01");
-     * @example await mobile.element.waitToBeVisible("#button12");
-     * @example await mobile.element.waitToBeVisible("p:first-child");
+     * @param {number} [timeout=30000] - The timeout to wait (ms).
+     * @returns {boolean} Returns true or false.
+     * @example
+     * await mobile.element.waitToBeVisible(".input01");
+     * await mobile.element.waitToBeVisible("#button12");
+     * await mobile.element.waitToBeVisible("p:first-child");
      */
-    waitToBeVisible(selector: any, timeout?: number): Promise<void>;
+    waitToBeVisible(selector: any, timeout?: number): Promise<boolean>;
     /**
      * @function waitToBeClickable
      * @memberof mobile.element
      * @description Waits until the element with the given selector is clickable.
      * @param {Object} selector - The CSS selector describing the element.
-     * @param {Number} [timeout=30000] - The timeout to wait (ms).
-     * @example await mobile.element.waitToBeClickable(".input01");
-     * @example await mobile.element.waitToBeClickable("#button12");
-     * @example await mobile.element.waitToBeClickable("p:first-child");
+     * @param {number} [timeout=30000] - The timeout to wait (ms).
+     * @returns {boolean} Returns true or false.
+     * @example
+     * await mobile.element.waitToBeClickable(".input01");
+     * await mobile.element.waitToBeClickable("#button12");
+     * await mobile.element.waitToBeClickable("p:first-child");
      */
-    waitToBeClickable(selector: any, timeout?: number): Promise<void>;
+    waitToBeClickable(selector: any, timeout?: number): Promise<boolean>;
     /**
      * @function isSelected
      * @memberof mobile.element
      * @description Returns a boolean if the element (e.g. checkbox) is selected.
-     * @param {Object} elem - The element.
-     * @returns {boolean}
-     * @example const elem = await mobile.element.getById("elem01");
+     * @param {Element | string} elementOrSelector - The element.
+     * @returns {boolean} Returns true or false.
+     * @example
      * const isSelected = await mobile.element.isSelected(elem);
      */
-    isSelected(elem: Element): Promise<boolean>;
+    isSelected(elementOrSelector: Element | string): Promise<boolean>;
+    /**
+     * @function waitToBeEnabled
+     * @memberof mobile.element
+     * @description Waits until the element with the given selector is present.
+     * @param {Object} selector - The CSS selector describing the element.
+     * @param {number} [timeout=30000] - The timeout to wait (ms).
+     * @returns {boolean} Returns true or false.
+     * @example
+     * await mobile.element.waitToBeEnabled(".input01");
+     * await mobile.element.waitToBeEnabled("#button12");
+     * await mobile.element.waitToBeEnabled("p:first-child");
+     */
+    waitToBeEnabled(selector: any, timeout?: number): Promise<boolean>;
 }
 declare const _default: ElementModule;
 export default _default;