appium-espresso-driver/build/lib/commands/idling-resources.js

Espresso integration for Appium

"use strict";
/**
 * @typedef {Object} IdlingResourcesOptions
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.mobileRegisterIdlingResources = mobileRegisterIdlingResources;
exports.mobileUnregisterIdlingResources = mobileUnregisterIdlingResources;
exports.mobileListIdlingResources = mobileListIdlingResources;
exports.mobileWaitForUIThread = mobileWaitForUIThread;
/**
 * Registers one or more idling resources
 *
 * @this {import('../driver').EspressoDriver}
 * @see https://github.com/appium/appium-espresso-driver?tab=readme-ov-file#mobile-registeridlingresources
 * @param {string} classNames - The comma-separated list of idling resources class names.
 * Each name must be a full-qualified java class name, like `io.appium.espressoserver.lib.MyIdlingResource`.
 * Each class in the app source must implement a singleton pattern and have a static `getInstance()`
 * method returning the class instance, which implements `androidx.test.espresso.IdlingResource`
 * interface. Read
 * - https://developer.android.com/training/testing/espresso/idling-resource
 * - https://android.jlelse.eu/integrate-espresso-idling-resources-in-your-app-to-build-flexible-ui-tests-c779e24f5057
 * for more details on how to design and use idling resources concept in Espresso.
 * @throws {Error} If there was a failure while parsing options or registering
 * the actual instances
 */
async function mobileRegisterIdlingResources(classNames) {
    return await this.espresso.jwproxy.command('/appium/execute_mobile/register_idling_resources', 'POST', {
        classNames,
    });
}
/**
 * Unregisters one or more idling resources
 *
 * @this {import('../driver').EspressoDriver}
 * @param {string} classNames - The comma-separated list of idling resources class names.
 * Each name must be a full-qualified java class name, like `io.appium.espressoserver.lib.MyIdlingResource`.
 * Each class in the app source must implement a singleton pattern and have a static `getInstance()`
 * method returning the class instance, which implements `androidx.test.espresso.IdlingResource`
 * interface. Read
 * - https://developer.android.com/training/testing/espresso/idling-resource
 * - https://android.jlelse.eu/integrate-espresso-idling-resources-in-your-app-to-build-flexible-ui-tests-c779e24f5057
 * for more details on how to design and use idling resources concept in Espresso.
 * @throws {Error} If there was a failure while parsing options or unregistering
 * the actual instances
 */
async function mobileUnregisterIdlingResources(classNames) {
    return await this.espresso.jwproxy.command('/appium/execute_mobile/unregister_idling_resources', 'POST', {
        classNames
    });
}
/**
 * Returns a list of currently registered idling resources
 * or an empty list if no resources have been registered yet.
 *
 * @this {import('../driver').EspressoDriver}
 * @returns {Promise<string[]>} The list of fully qualified class names
 */
async function mobileListIdlingResources() {
    return /** @type {string[]} */ (await this.espresso.jwproxy.command('/appium/execute_mobile/list_idling_resources', 'GET'));
}
/**
 * Wait for UI thread to be idle.
 * @this {import('../driver').EspressoDriver}
 */
async function mobileWaitForUIThread() {
    return await this.espresso.jwproxy.command('/appium/execute_mobile/ui_thread_sync', 'POST');
}
//# sourceMappingURL=idling-resources.js.map