appium-android-driver 5.14.7 → 6.0.1

package/build/lib/unlock-helpers.js

@@ -1,266 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FINGERPRINT_UNLOCK = exports.PATTERN_UNLOCK = exports.PASSWORD_UNLOCK = exports.PIN_UNLOCK_KEY_EVENT = exports.PIN_UNLOCK = exports.helpers = void 0;
-const logger_1 = __importDefault(require("./logger"));
-const asyncbox_1 = require("asyncbox");
-const lodash_1 = __importDefault(require("lodash"));
-const support_1 = require("@appium/support");
-const PIN_UNLOCK = 'pin';
-exports.PIN_UNLOCK = PIN_UNLOCK;
-const PIN_UNLOCK_KEY_EVENT = 'pinWithKeyEvent';
-exports.PIN_UNLOCK_KEY_EVENT = PIN_UNLOCK_KEY_EVENT;
-const PASSWORD_UNLOCK = 'password';
-exports.PASSWORD_UNLOCK = PASSWORD_UNLOCK;
-const PATTERN_UNLOCK = 'pattern';
-exports.PATTERN_UNLOCK = PATTERN_UNLOCK;
-const FINGERPRINT_UNLOCK = 'fingerprint';
-exports.FINGERPRINT_UNLOCK = FINGERPRINT_UNLOCK;
-const UNLOCK_TYPES = [
-    PIN_UNLOCK, PIN_UNLOCK_KEY_EVENT, PASSWORD_UNLOCK,
-    PATTERN_UNLOCK, FINGERPRINT_UNLOCK
-];
-const KEYCODE_NUMPAD_ENTER = 66;
-const UNLOCK_WAIT_TIME = 100;
-const INPUT_KEYS_WAIT_TIME = 100;
-const NUMBER_ZERO_KEYCODE = 7;
-exports.helpers = {};
-exports.helpers.validateUnlockCapabilities = function validateUnlockCapabilities(caps = {}) {
-    const { unlockKey, unlockType, } = caps;
-    if (lodash_1.default.isNil(unlockKey) || unlockKey === '') {
-        throw new Error('A non-empty unlock key value must be provided');
-    }
-    if ([PIN_UNLOCK, PIN_UNLOCK_KEY_EVENT, FINGERPRINT_UNLOCK].includes(unlockType)) {
-        if (!/^[0-9]+$/.test(lodash_1.default.trim(unlockKey))) {
-            throw new Error(`Unlock key value '${unlockKey}' must only consist of digits`);
-        }
-    }
-    else if (unlockType === PATTERN_UNLOCK) {
-        if (!/^[1-9]{2,9}$/.test(lodash_1.default.trim(unlockKey))) {
-            throw new Error(`Unlock key value '${unlockKey}' must only include from two to nine digits in range 1..9`);
-        }
-        if (/([1-9]).*?\1/.test(lodash_1.default.trim(unlockKey))) {
-            throw new Error(`Unlock key value '${unlockKey}' must define a valid pattern where repeats are not allowed`);
-        }
-    }
-    else if (unlockType === PASSWORD_UNLOCK) {
-        // Dont trim password key, you can use blank spaces in your android password
-        // ¯\_(ツ)_/¯
-        if (!/.{4,}/g.test(unlockKey)) {
-            throw new Error(`The minimum allowed length of unlock key value '${unlockKey}' is 4 characters`);
-        }
-    }
-    else {
-        throw new Error(`Invalid unlock type '${unlockType}'. ` +
-            `Only the following unlock types are supported: ${UNLOCK_TYPES}`);
-    }
-    return caps;
-};
-exports.helpers.fastUnlock = async function fastUnlock(adb, opts = {}) {
-    const { credential, credentialType, } = opts;
-    logger_1.default.info(`Unlocking the device via ADB using ${credentialType} credential '${credential}'`);
-    const wasLockEnabled = await adb.isLockEnabled();
-    if (wasLockEnabled) {
-        await adb.clearLockCredential(credential);
-        // not sure why, but the device's screen still remains locked
-        // if a preliminary wake up cycle has not been performed
-        await adb.cycleWakeUp();
-    }
-    else {
-        logger_1.default.info('No active lock has been detected. Proceeding to the keyguard dismissal');
-    }
-    try {
-        await adb.dismissKeyguard();
-    }
-    finally {
-        if (wasLockEnabled) {
-            await adb.setLockCredential(credentialType, credential);
-        }
-    }
-};
-exports.helpers.encodePassword = function encodePassword(key) {
-    return `${key}`.replace(/\s/ig, '%s');
-};
-exports.helpers.stringKeyToArr = function stringKeyToArr(key) {
-    return `${key}`.trim().replace(/\s+/g, '').split(/\s*/);
-};
-exports.helpers.fingerprintUnlock = async function fingerprintUnlock(adb, driver, capabilities) {
-    if (await adb.getApiLevel() < 23) {
-        throw new Error('Fingerprint unlock only works for Android 6+ emulators');
-    }
-    await adb.fingerprint(capabilities.unlockKey);
-    await (0, asyncbox_1.sleep)(UNLOCK_WAIT_TIME);
-};
-exports.helpers.pinUnlock = async function pinUnlock(adb, driver, capabilities) {
-    logger_1.default.info(`Trying to unlock device using pin ${capabilities.unlockKey}`);
-    await adb.dismissKeyguard();
-    const keys = exports.helpers.stringKeyToArr(capabilities.unlockKey);
-    if (await adb.getApiLevel() >= 21) {
-        const els = await driver.findElOrEls('id', 'com.android.systemui:id/digit_text', true);
-        if (lodash_1.default.isEmpty(els)) {
-            // fallback to pin with key event
-            return await exports.helpers.pinUnlockWithKeyEvent(adb, driver, capabilities);
-        }
-        const pins = {};
-        for (const el of els) {
-            const text = await driver.getAttribute('text', support_1.util.unwrapElement(el));
-            pins[text] = el;
-        }
-        for (const pin of keys) {
-            const el = pins[pin];
-            await driver.click(support_1.util.unwrapElement(el));
-        }
-    }
-    else {
-        for (const pin of keys) {
-            const el = await driver.findElOrEls('id', `com.android.keyguard:id/key${pin}`, false);
-            if (el === null) {
-                // fallback to pin with key event
-                return await exports.helpers.pinUnlockWithKeyEvent(adb, driver, capabilities);
-            }
-            await driver.click(support_1.util.unwrapElement(el));
-        }
-    }
-    await waitForUnlock(adb);
-};
-/**
- * Wait for the display to be unlocked.
- * Some devices automatically accept typed 'pin' and 'password' code
- * without pressing the Enter key. But some devices need it.
- * This method waits a few seconds first for such automatic acceptance case.
- * If the device is still locked, then this method will try to send
- * the enter key code.
- *
- * @param {ADB} adb The instance of ADB
- */
-async function waitForUnlock(adb) {
-    await (0, asyncbox_1.sleep)(UNLOCK_WAIT_TIME);
-    if (!await adb.isScreenLocked()) {
-        return;
-    }
-    await adb.keyevent(KEYCODE_NUMPAD_ENTER);
-    await (0, asyncbox_1.sleep)(UNLOCK_WAIT_TIME);
-}
-exports.helpers.pinUnlockWithKeyEvent = async function pinUnlockWithKeyEvent(adb, driver, capabilities) {
-    logger_1.default.info(`Trying to unlock device using pin with keycode ${capabilities.unlockKey}`);
-    await adb.dismissKeyguard();
-    const keys = exports.helpers.stringKeyToArr(capabilities.unlockKey);
-    // Some device does not have system key ids like 'com.android.keyguard:id/key'
-    // Then, sending keyevents are more reliable to unlock the screen.
-    for (const pin of keys) {
-        // 'pin' is number (0-9) in string.
-        // Number '0' is keycode '7'. number '9' is keycode '16'.
-        await adb.shell(['input', 'keyevent', parseInt(pin, 10) + NUMBER_ZERO_KEYCODE]);
-    }
-    await waitForUnlock(adb, driver);
-};
-exports.helpers.passwordUnlock = async function passwordUnlock(adb, driver, capabilities) {
-    const { unlockKey } = capabilities;
-    logger_1.default.info(`Trying to unlock device using password ${unlockKey}`);
-    await adb.dismissKeyguard();
-    // Replace blank spaces with %s
-    const key = exports.helpers.encodePassword(unlockKey);
-    // Why adb ? It was less flaky
-    await adb.shell(['input', 'text', key]);
-    // Why sleeps ? Avoid some flakyness waiting for the input to receive the keys
-    await (0, asyncbox_1.sleep)(INPUT_KEYS_WAIT_TIME);
-    await adb.shell(['input', 'keyevent', KEYCODE_NUMPAD_ENTER]);
-    // Waits a bit for the device to be unlocked
-    await waitForUnlock(adb, driver);
-};
-exports.helpers.getPatternKeyPosition = function getPatternKeyPosition(key, initPos, piece) {
-    /*
-    How the math works:
-    We have 9 buttons divided in 3 columns and 3 rows inside the lockPatternView,
-    every button has a position on the screen corresponding to the lockPatternView since
-    it is the parent view right at the middle of each column or row.
-    */
-    const cols = 3;
-    const pins = 9;
-    const xPos = (key, x, piece) => Math.round(x + ((key % cols) || cols) * piece - piece / 2);
-    const yPos = (key, y, piece) => Math.round(y + (Math.ceil(((key % pins) || pins) / cols) * piece - piece / 2));
-    return {
-        x: xPos(key, initPos.x, piece),
-        y: yPos(key, initPos.y, piece)
-    };
-};
-exports.helpers.getPatternActions = function getPatternActions(keys, initPos, piece) {
-    const actions = [];
-    let lastPos;
-    for (let key of keys) {
-        const keyPos = exports.helpers.getPatternKeyPosition(key, initPos, piece);
-        if (key === keys[0]) {
-            actions.push({ action: 'press', options: { element: null, x: keyPos.x, y: keyPos.y } });
-            lastPos = keyPos;
-            continue;
-        }
-        const moveTo = { x: 0, y: 0 };
-        const diffX = keyPos.x - lastPos.x;
-        if (diffX > 0) {
-            moveTo.x = piece;
-            if (Math.abs(diffX) > piece) {
-                moveTo.x += piece;
-            }
-        }
-        else if (diffX < 0) {
-            moveTo.x = -1 * piece;
-            if (Math.abs(diffX) > piece) {
-                moveTo.x -= piece;
-            }
-        }
-        const diffY = keyPos.y - lastPos.y;
-        if (diffY > 0) {
-            moveTo.y = piece;
-            if (Math.abs(diffY) > piece) {
-                moveTo.y += piece;
-            }
-        }
-        else if (diffY < 0) {
-            moveTo.y = -1 * piece;
-            if (Math.abs(diffY) > piece) {
-                moveTo.y -= piece;
-            }
-        }
-        actions.push({
-            action: 'moveTo',
-            options: { element: null, x: moveTo.x + lastPos.x, y: moveTo.y + lastPos.y }
-        });
-        lastPos = keyPos;
-    }
-    actions.push({ action: 'release' });
-    return actions;
-};
-exports.helpers.patternUnlock = async function patternUnlock(adb, driver, capabilities) {
-    const { unlockKey } = capabilities;
-    logger_1.default.info(`Trying to unlock device using pattern ${unlockKey}`);
-    await adb.dismissKeyguard();
-    const keys = exports.helpers.stringKeyToArr(unlockKey);
-    /* We set the device pattern buttons as number of a regular phone
-     *  | • • • |     | 1 2 3 |
-     *  | • • • | --> | 4 5 6 |
-     *  | • • • |     | 7 8 9 |
-  
-    The pattern view buttons are not seeing by the uiautomator since they are
-    included inside a FrameLayout, so we are going to try clicking on the buttons
-    using the parent view bounds and math.
-    */
-    const apiLevel = await adb.getApiLevel();
-    const el = await driver.findElOrEls('id', `com.android.${apiLevel >= 21 ? 'systemui' : 'keyguard'}:id/lockPatternView`, false);
-    const initPos = await driver.getLocation(support_1.util.unwrapElement(el));
-    const size = await driver.getSize(support_1.util.unwrapElement(el));
-    // Get actions to perform
-    const actions = exports.helpers.getPatternActions(keys, initPos, size.width / 3);
-    // Perform gesture
-    await driver.performTouch(actions);
-    // Waits a bit for the device to be unlocked
-    await (0, asyncbox_1.sleep)(UNLOCK_WAIT_TIME);
-};
-exports.helpers.PIN_UNLOCK = PIN_UNLOCK;
-exports.helpers.PIN_UNLOCK_KEY_EVENT = PIN_UNLOCK_KEY_EVENT;
-exports.helpers.PASSWORD_UNLOCK = PASSWORD_UNLOCK;
-exports.helpers.PATTERN_UNLOCK = PATTERN_UNLOCK;
-exports.helpers.FINGERPRINT_UNLOCK = FINGERPRINT_UNLOCK;
-exports.default = exports.helpers;
-//# sourceMappingURL=unlock-helpers.js.map

package/build/lib/unlock-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unlock-helpers.js","sourceRoot":"","sources":["../../lib/unlock-helpers.js"],"names":[],"mappings":"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"}

package/build/lib/webview-helpers.d.ts

@@ -1,224 +0,0 @@
-export default helpers;
-export type WebviewProc = {
-    /**
-     * - The webview process name (as returned by
-     * getPotentialWebviewProcs
-     */
-    proc: string;
-    /**
-     * - The actual webview context name
-     */
-    webview: string;
-};
-export type WebviewProps = {
-    /**
-     * The name of the Devtools Unix socket
-     */
-    proc: string;
-    /**
-     * The web view alias. Looks like `WEBVIEW_`
-     * prefix plus PID or package name
-     */
-    webview: string;
-    /**
-     * Webview information as it is retrieved by
-     * /json/version CDP endpoint
-     */
-    info: any | null;
-    /**
-     * Webview pages list as it is retrieved by
-     * /json/list CDP endpoint
-     */
-    pages: Array<any> | null;
-};
-export type DetailCollectionOptions = {
-    /**
-     * The starting port to use for webview page
-     * presence check (if not the default of 9222).
-     */
-    webviewDevtoolsPort: (string | number) | null;
-    /**
-     * Whether to check for webview
-     * pages presence
-     */
-    ensureWebviewsHavePages: boolean | null;
-    /**
-     * Whether to collect
-     * web view details and send them to Chromedriver constructor, so it could
-     * select a binary more precisely based on this info.
-     */
-    enableWebviewDetailsCollection: boolean;
-};
-export type GetWebviewsOpts = {
-    /**
-     * [null] - device socket name
-     */
-    androidDeviceSocket: string;
-    /**
-     * [true] - whether to check for webview
-     * page presence
-     */
-    ensureWebviewsHavePages: boolean;
-    /**
-     * [9222] - port to use for webview page
-     * presence check.
-     */
-    webviewDevtoolsPort: number;
-    /**
-     * [true] - whether to collect
-     * web view details and send them to Chromedriver constructor, so it could
-     * select a binary more precisely based on this info.
-     */
-    enableWebviewDetailsCollection: boolean;
-};
-export type WebviewsMapping = {
-    /**
-     * See note on WebviewProps
-     */
-    proc: string;
-    /**
-     * See note on WebviewProps
-     */
-    webview: string;
-    /**
-     * See note on WebviewProps
-     */
-    info: any | null;
-    /**
-     * See note on WebviewProps
-     */
-    pages: Array<any> | null;
-};
-export type ProcessInfo = {
-    /**
-     * The process name
-     */
-    name: string;
-    /**
-     * The process id (if could be retrieved)
-     */
-    id: string | null;
-};
-export type WebViewDetails = {
-    /**
-     * - Web view process details
-     */
-    process: ProcessInfo | null;
-    /**
-     * - Web view details as returned by /json/version CDP endpoint, for example:
-     * {
-     * "Browser": "Chrome/72.0.3601.0",
-     * "Protocol-Version": "1.3",
-     * "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3601.0 Safari/537.36",
-     * "V8-Version": "7.2.233",
-     * "WebKit-Version": "537.36 (@cfede9db1d154de0468cb0538479f34c0755a0f4)",
-     * "webSocketDebuggerUrl": "ws://localhost:9222/devtools/browser/b0b8a4fb-bb17-4359-9533-a8d9f3908bd8"
-     * }
-     */
-    info: any;
-};
-export namespace helpers {
-    /**
-     * Take a webview name like WEBVIEW_4296 and use 'adb shell ps' to figure out
-     * which app package is associated with that webview. One of the reasons we
-     * want to do this is to make sure we're listing webviews for the actual AUT,
-     * not some other running app
-     *
-     * @param {object} adb - an ADB instance
-     * @param {string} webview - a webview process name
-     *
-     * @returns {string} - the package name of the app running the webview
-     * @throws {Error} If there was a failure while retrieving the process name
-     */
-    function procFromWebview(adb: any, webview: string): string;
-    /**
-     * Parse webview names for getContexts
-     *
-     * @param {Array<WebviewsMapping>} webviewsMapping See note on getWebViewsMapping
-     * @param {GetWebviewsOpts} opts See note on getWebViewsMapping
-     * @return {Array.<string>} - a list of webview names
-     */
-    function parseWebviewNames(webviewsMapping: WebviewsMapping[], { ensureWebviewsHavePages, isChromeSession }?: GetWebviewsOpts): string[];
-    /**
-     * @typedef {Object} GetWebviewsOpts
-     * @property {string} androidDeviceSocket [null] - device socket name
-     * @property {boolean} ensureWebviewsHavePages [true] - whether to check for webview
-     * page presence
-     * @property {number} webviewDevtoolsPort [9222] - port to use for webview page
-     * presence check.
-     * @property {boolean} enableWebviewDetailsCollection [true] - whether to collect
-     * web view details and send them to Chromedriver constructor, so it could
-     * select a binary more precisely based on this info.
-     */
-    /**
-     * @typedef {Object} WebviewsMapping
-     * @property {string} proc See note on WebviewProps
-     * @property {string} webview See note on WebviewProps
-     * @property {?Object} info See note on WebviewProps
-     * @property {?Array<Object>} pages See note on WebviewProps
-     * @propery {?string} webviewName An actual webview name for switching context
-     */
-    /**
-     * Get a list of available webviews mapping by introspecting processes with adb,
-     * where webviews are listed. It's possible to pass in a 'deviceSocket' arg, which
-     * limits the webview possibilities to the one running on the Chromium devtools
-     * socket we're interested in (see note on webviewsFromProcs). We can also
-     * direct this method to verify whether a particular webview process actually
-     * has any pages (if a process exists but no pages are found, Chromedriver will
-     * not actually be able to connect to it, so this serves as a guard for that
-     * strange failure mode). The strategy for checking whether any pages are
-     * active involves sending a request to the remote debug server on the device,
-     * hence it is also possible to specify the port on the host machine which
-     * should be used for this communication.
-     *
-     * @param {object} adb - an ADB instance
-     * @param {GetWebviewsOpts} opts
-     *
-     * @return {Array<WebviewsMapping>} webviewsMapping
-     */
-    function getWebViewsMapping(adb: any, { androidDeviceSocket, ensureWebviewsHavePages, webviewDevtoolsPort, enableWebviewDetailsCollection, }?: GetWebviewsOpts): WebviewsMapping[];
-    /**
-     * @typedef {Object} ProcessInfo
-     * @property {string} name The process name
-     * @property {?string} id The process id (if could be retrieved)
-     */
-    /**
-     * @typedef {Object} WebViewDetails
-     * @property {?ProcessInfo} process - Web view process details
-     * @property {Object} info - Web view details as returned by /json/version CDP endpoint, for example:
-     * {
-     *  "Browser": "Chrome/72.0.3601.0",
-     *  "Protocol-Version": "1.3",
-     *  "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/72.0.3601.0 Safari/537.36",
-     *  "V8-Version": "7.2.233",
-     *  "WebKit-Version": "537.36 (@cfede9db1d154de0468cb0538479f34c0755a0f4)",
-     *  "webSocketDebuggerUrl": "ws://localhost:9222/devtools/browser/b0b8a4fb-bb17-4359-9533-a8d9f3908bd8"
-     * }
-     */
-    /**
-     * Retrieves web view details previously cached by `getWebviews` call
-     *
-     * @param {ADB} adb ADB instance
-     * @param {string} webview The name of the web view
-     * @returns {?WebViewDetails} Either `undefined` or the recent web view details
-     */
-    function getWebviewDetails(adb: ADB, webview: string): WebViewDetails | null;
-    /**
-     * Create Chrome driver capabilities based on the provided
-     * Appium capabilities
-     *
-     * @param {Object} opts User-provided capabilities object
-     * @param {string} deviceId The identifier of the Android device under test
-     * @param {?WebViewDetails} webViewDetails
-     * @returns {Object} The capabilities object.
-     * See https://chromedriver.chromium.org/capabilities for more details.
-     */
-    function createChromedriverCaps(opts: any, deviceId: string, webViewDetails: WebViewDetails | null): any;
-}
-export const NATIVE_WIN: "NATIVE_APP";
-export const WEBVIEW_WIN: "WEBVIEW";
-export const WEBVIEW_BASE: "WEBVIEW_";
-export const CHROMIUM_WIN: "CHROMIUM";
-export const KNOWN_CHROME_PACKAGE_NAMES: string[];
-export const DEVTOOLS_SOCKET_PATTERN: RegExp;
-//# sourceMappingURL=webview-helpers.d.ts.map

package/build/lib/webview-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webview-helpers.d.ts","sourceRoot":"","sources":["../../lib/webview-helpers.js"],"names":[],"mappings":";;;;;;UA4Fc,MAAM;;;;aAEN,MAAM;;;;;;UA+FN,MAAM;;;;;aACN,MAAM;;;;;;;;;;WAIL,UAAa;;;;;;;0BAMb,MAAM,GAAC,MAAM;;;;;6BAEb,OAAO;;;;;;oCAER,OAAO;;;;;;yBAoKP,MAAM;;;;;6BACN,OAAO;;;;;yBAEP,MAAM;;;;;;oCAEN,OAAO;;;;;;UAOP,MAAM;;;;aACN,MAAM;;;;;;;;WAEL,UAAa;;;;;;UA6Ed,MAAM;;;;QACL,MAAM;;;;;;aAKN,WAAW;;;;;;;;;;;;;;;IAhK1B;;;;;;;;;;;OAWG;IACH,4DAYC;IAED;;;;;;OAMG;IACH,yIAyBC;IAED;;;;;;;;;;OAUG;IAEH;;;;;;;OAOG;IAEH;;;;;;;;;;;;;;;;;OAiBG;IACH,mLAmDC;IAED;;;;OAIG;IAEH;;;;;;;;;;;;OAYG;IAEH;;;;;;OAMG;IACH,6EAGC;IAED;;;;;;;;;OASG;IACH,yGA0FC;;AApkBD,sCAAgC;AAChC,oCAA8B;AAE9B,sCAAuC;AADvC,sCAAgC;AAQhC,kDAKE;AATF,6CAA8E"}