@limrun/appium-xcuitest-driver 10.4.3-lim.1

package/build/lib/commands/context.js

@@ -0,0 +1,625 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContextsAndViews = getContextsAndViews;
+exports.useNewSafari = useNewSafari;
+exports.activateRecentWebview = activateRecentWebview;
+exports.listWebFrames = listWebFrames;
+exports.connectToRemoteDebugger = connectToRemoteDebugger;
+exports.mobileGetContexts = mobileGetContexts;
+exports.onPageChange = onPageChange;
+exports.stopRemote = stopRemote;
+exports.setCurrentUrl = setCurrentUrl;
+exports.getCurrentUrl = getCurrentUrl;
+exports.getRecentWebviewContextId = getRecentWebviewContextId;
+exports.isWebContext = isWebContext;
+exports.isWebview = isWebview;
+exports.getNewRemoteDebugger = getNewRemoteDebugger;
+exports.getCurrentContext = getCurrentContext;
+exports.setContext = setContext;
+exports.getContexts = getContexts;
+exports.setWindow = setWindow;
+exports.getWindowHandle = getWindowHandle;
+exports.getWindowHandles = getWindowHandles;
+exports.notifyBiDiContextChange = notifyBiDiContextChange;
+const appium_remote_debugger_1 = require("appium-remote-debugger");
+const driver_1 = require("appium/driver");
+const support_1 = require("appium/support");
+const ios_performance_log_1 = require("../device-log/ios-performance-log");
+const lodash_1 = __importDefault(require("lodash"));
+const utils_1 = require("../utils");
+const models_1 = require("./bidi/models");
+const constants_1 = require("./bidi/constants");
+const log_1 = require("./log");
+const WEBVIEW_WIN = 'WEBVIEW';
+const WEBVIEW_BASE = `${WEBVIEW_WIN}_`;
+const DEFAULT_REMOTE_DEBUGGER_CONNECT_TIMEOUT_MS = 5000;
+const DEFAULT_LIST_WEB_FRAMES_RETRIES = 20;
+const DEFAULT_NATIVE_WINDOW_HANDLE = '1';
+/**
+ * @this {XCUITestDriver}
+ * @param {boolean} [useUrl=false]
+ * @returns {Promise<import('./types').ViewContext[]>}
+ */
+async function getContextsAndViews(useUrl = true) {
+    this.log.debug('Retrieving contexts and views');
+    const webviews = await this.listWebFrames(useUrl);
+    /**
+     * @type {import('./types').ViewContext[]}
+     */
+    const ctxs = [{ id: utils_1.NATIVE_WIN, view: {} }];
+    this.contexts = [utils_1.NATIVE_WIN];
+    for (const view of webviews) {
+        ctxs.push({ id: `${WEBVIEW_BASE}${view.id}`, view });
+        this.contexts.push(view.id.toString());
+    }
+    return ctxs;
+}
+/**
+ * @deprecated this method is not used anywhere and will be removed in the future
+ * @this {XCUITestDriver}
+ * @returns {boolean}
+ */
+function useNewSafari() {
+    return this.isSimulator() && this.isSafari();
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ */
+async function activateRecentWebview() {
+    this.log.debug('Activating a recent webview');
+    const timer = new support_1.timing.Timer().start();
+    const contextId = await this.getRecentWebviewContextId(/.*/, /.*/);
+    if (contextId) {
+        this.log.info(`Picking webview '${contextId}' after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`);
+        await this.setContext(contextId);
+        return;
+    }
+    const appDict = ( /** @type {RemoteDebugger} */(this.remote)).appDict;
+    const errSuffix = `Make sure your web application is debuggable ` +
+        `and could be inspected in Safari Web Inspector.`;
+    if (lodash_1.default.isEmpty(appDict)) {
+        throw new Error(`The remote debugger did not return any connected web applications after ` +
+            `${timer.getDuration().asMilliSeconds.toFixed(0)}ms. ` +
+            `${errSuffix} ` +
+            `You may try to change the 'webviewConnectTimeout' capability value to ` +
+            `customize the retrieval timeout.`);
+    }
+    const errSuffix2 = `${errSuffix} You may try to change the 'webviewConnectRetries' ` +
+        `capability value to customize the amount of pages retrieval retries.`;
+    const appsWithPages = lodash_1.default.values(appDict).filter(({ pageArray }) => !lodash_1.default.isEmpty(pageArray));
+    if (appsWithPages.length > 0) {
+        throw new Error(`The remote debugger returned ${support_1.util.pluralize('web application', appsWithPages.length, true)} ` +
+            `with pages after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms, ` +
+            `although none of them matched our page search criteria. ${errSuffix2}`);
+    }
+    else {
+        throw new Error(`The remote debugger returned ${support_1.util.pluralize('web application', lodash_1.default.size(appDict), true)}, ` +
+            `but none of them had pages after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms. ` +
+            `${errSuffix2} Also, in rare cases the device restart or device OS upgrade may fix this ` +
+            `issue if none of the above advices helps.`);
+    }
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<import('../types').Page[]>}
+ */
+async function listWebFrames(useUrl = true) {
+    const shouldFilterByUrl = useUrl && !this.isRealDevice() && !!this.getCurrentUrl();
+    this.log.debug(`Selecting by url: ${shouldFilterByUrl}` +
+        (shouldFilterByUrl ? ` (expected url: '${this.getCurrentUrl()}')` : ''));
+    if (!this.remote) {
+        await this.connectToRemoteDebugger();
+    }
+    const doListPages = async (/** @type {number} */ retries) => {
+        try {
+            const pageArray = await ( /** @type {RemoteDebugger} */(this.remote)).selectApp(shouldFilterByUrl ? this.getCurrentUrl() : undefined, retries, this.opts.ignoreAboutBlankUrl);
+            if (lodash_1.default.isEmpty(pageArray)) {
+                // we have no web frames, but continue anyway
+                this.log.debug(`No web frames found after ${support_1.util.pluralize('retry', retries, true)}`);
+            }
+            return pageArray;
+        }
+        catch (err) {
+            this.log.debug(`No available web pages after ${support_1.util.pluralize('retry', retries, true)}: ${err.message}`);
+            return [];
+        }
+    };
+    /** @type {number} */
+    const maxRetriesCount = lodash_1.default.isInteger(this.opts.webviewConnectRetries)
+        ? Math.max(/** @type {number} */ (this.opts.webviewConnectRetries), 1)
+        : DEFAULT_LIST_WEB_FRAMES_RETRIES;
+    this.log.debug(`About to select a web application with ${support_1.util.pluralize('retry', maxRetriesCount, true)} ` +
+        `and 500ms interval between each retry. Consider customizing the value of 'webviewConnectRetries' ` +
+        `capability to change the amount of retries.`);
+    return await doListPages(maxRetriesCount);
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ */
+async function connectToRemoteDebugger() {
+    this.remote = await this.getNewRemoteDebugger();
+    // @ts-ignore static is fine
+    this.remote.on(appium_remote_debugger_1.RemoteDebugger.EVENT_PAGE_CHANGE, this.onPageChange.bind(this));
+    // @ts-ignore static is fine
+    this.remote.on(appium_remote_debugger_1.RemoteDebugger.EVENT_FRAMES_DETACHED, () => {
+        if (!lodash_1.default.isEmpty(this.curWebFrames)) {
+            const curWebFrames = this.curWebFrames;
+            this.log.debug(`Clearing ${support_1.util.pluralize('frame', curWebFrames.length, true)}: ${curWebFrames.join(', ')}`);
+        }
+        this.curWebFrames = [];
+    });
+    const timeoutMs = this.opts.webviewConnectTimeout ?? DEFAULT_REMOTE_DEBUGGER_CONNECT_TIMEOUT_MS;
+    const apps = await this.remote.connect(timeoutMs);
+    if (lodash_1.default.isEmpty(apps)) {
+        this.log.info(`The remote debugger did not report any active web applications within ${timeoutMs}ms timeout. ` +
+            `Consider increasing the value of 'webviewConnectTimeout' capability to wait longer ` +
+            `on slower devices.`);
+    }
+}
+/**
+ * Retrieves the list of available contexts.
+ *
+ * The list includes extended context information, like URLs and page names.
+ * This is different from the standard `getContexts` API, because the latter
+ * only has web view names without any additional information.
+ *
+ * @remarks In situations where multiple web views are available at once, the
+ * client code would have to connect to each of them in order to detect the
+ * one which needs to be interacted with. This extra effort is not needed with
+ * the information provided by this extension.
+ * @param {number} [waitForWebviewMs=0] - The period to poll for available webview(s) (in ms)
+ * @returns {Promise<Context[]>} The list of available context objects along with their properties.
+ * @this {XCUITestDriver}
+ */
+async function mobileGetContexts(waitForWebviewMs = 0) {
+    // make sure it is a number, so the duration check works properly
+    if (!lodash_1.default.isNumber(waitForWebviewMs)) {
+        waitForWebviewMs = parseInt(waitForWebviewMs, 10);
+        if (isNaN(waitForWebviewMs)) {
+            waitForWebviewMs = 0;
+        }
+    }
+    const curOpt = this.opts.fullContextList;
+    this.opts.fullContextList = true;
+    const timer = new support_1.timing.Timer().start();
+    try {
+        /** @type {FullContext[]} */
+        let contexts;
+        do {
+            contexts = /** @type {FullContext[]} */ (await this.getContexts());
+            if (contexts.length >= 2) {
+                this.log.debug(`Found webview context after ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`);
+                return contexts;
+            }
+            this.log.debug(`No webviews found in ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`);
+        } while (timer.getDuration().asMilliSeconds < waitForWebviewMs);
+        return contexts;
+    }
+    finally {
+        // reset the option so there are no side effects
+        this.opts.fullContextList = curOpt;
+    }
+}
+/**
+ * @this {XCUITestDriver}
+ * @param {import('./types').PageChangeNotification} pageChangeNotification
+ * @returns {Promise<void>}
+ */
+async function onPageChange(pageChangeNotification) {
+    this.log.debug(`Remote debugger notified us of a new page listing: ${JSON.stringify(pageChangeNotification)}`);
+    if (this.selectingNewPage) {
+        this.log.debug('We are in the middle of selecting a page, ignoring');
+        return;
+    }
+    if (!this.remote?.isConnected) {
+        this.log.debug('We have not yet connected, ignoring');
+        return;
+    }
+    const { appIdKey, pageArray } = pageChangeNotification;
+    /** @type {string[]} */
+    const newIds = [];
+    /** @type {string[]} */
+    const newPages = [];
+    /** @type {string|null} */
+    let keyId = null;
+    for (const page of pageArray) {
+        const id = page.id.toString();
+        newIds.push(id);
+        if (page.isKey) {
+            keyId = id;
+        }
+        const contextId = `${appIdKey}.${id}`;
+        // add if this is a new page
+        if (!lodash_1.default.includes(this.contexts, contextId)) {
+            if (isUrlIgnored(page.url, this.opts.safariIgnoreWebHostnames)) {
+                this.log.info(`Not tracking '${page.url}' page because it is blacklisted. ` +
+                    `'safariIgnoreWebHostnames'=${this.opts.safariIgnoreWebHostnames}`);
+            }
+            else {
+                newPages.push(id);
+                this.contexts.push(contextId);
+            }
+        }
+    }
+    if (!keyId) {
+        // if there is no key id, pull the first id from the page array and use that
+        // as a stand in
+        this.log.debug('No key id found. Choosing first id from page array');
+        keyId = newIds[0] || null;
+    }
+    if (!support_1.util.hasValue(this.curContext)) {
+        this.log.debug('We do not appear to have window set yet, ignoring');
+        return;
+    }
+    const [curAppIdKey, curPageIdKey] = this.curContext.split('.');
+    if (curAppIdKey !== appIdKey) {
+        this.log.debug('Page change not referring to currently selected app, ignoring.');
+        return;
+    }
+    /** @type {string|null} */
+    let newPage = null;
+    if (newPages.length) {
+        newPage = /** @type {string} */ (lodash_1.default.last(newPages));
+        this.log.debug(`We have new pages, selecting page '${newPage}'`);
+    }
+    else if (!lodash_1.default.includes(newIds, curPageIdKey)) {
+        this.log.debug('New page listing from remote debugger does not contain ' +
+            'current window; assuming it is closed');
+        if (!support_1.util.hasValue(keyId)) {
+            this.log.error('Do not have our current window anymore, and there ' +
+                'are not any more to load! Doing nothing...');
+            this.setCurrentUrl(undefined);
+            return;
+        }
+        this.log.debug(`Debugger already selected page '${keyId}', ` + `confirming that choice.`);
+        this.curContext = `${appIdKey}.${keyId}`;
+        newPage = keyId;
+    }
+    else {
+        // at this point, there are no new pages, and the current page still exists
+        this.log.debug('New page listing is same as old, doing nothing');
+    }
+    // make sure that the page listing isn't indicating a redirect
+    if (support_1.util.hasValue(this.curContext)) {
+        const currentPageId = parseInt(String(lodash_1.default.last(this.curContext.split('.'))), 10);
+        const page = lodash_1.default.find(pageArray, (p) => parseInt(String(p.id), 10) === currentPageId);
+        if (page && page.url !== this.getCurrentUrl()) {
+            this.log.debug(`Redirected from '${this.getCurrentUrl()}' to '${page.url}'`);
+            this.setCurrentUrl(page.url);
+        }
+    }
+    if (support_1.util.hasValue(newPage)) {
+        this.selectingNewPage = true;
+        const oldContext = this.curContext;
+        this.curContext = `${appIdKey}.${newPage}`;
+        try {
+            await this.remote.selectPage(appIdKey, parseInt(newPage, 10));
+            await notifyBiDiContextChange.bind(this)();
+        }
+        catch (e) {
+            this.log.warn(`Failed to select page: ${e.message}`);
+            this.curContext = oldContext;
+        }
+        finally {
+            this.selectingNewPage = false;
+        }
+    }
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ */
+async function stopRemote(closeWindowBeforeDisconnecting = false) {
+    if (!this.remote) {
+        throw this.log.errorWithException('Tried to leave a web frame but were not in one');
+    }
+    if (closeWindowBeforeDisconnecting) {
+        await this.closeWindow();
+    }
+    await this.remote.disconnect();
+    this.curContext = null;
+    await notifyBiDiContextChange.bind(this)();
+    this.curWebFrames = [];
+    this.remote = null;
+}
+/**
+ * @this {XCUITestDriver}
+ * @param {string|undefined|null} url
+ */
+function setCurrentUrl(url) {
+    this._currentUrl = url;
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {string|undefined|null}
+ */
+function getCurrentUrl() {
+    return this._currentUrl;
+}
+/**
+ * @param {RegExp} titleRegExp
+ * @param {RegExp} urlRegExp
+ * @this {XCUITestDriver}
+ * @returns {Promise<string|undefined>}
+ */
+async function getRecentWebviewContextId(titleRegExp, urlRegExp) {
+    if (!lodash_1.default.isRegExp(titleRegExp) && !lodash_1.default.isRegExp(urlRegExp)) {
+        throw new driver_1.errors.InvalidArgumentError('A regular expression for either web view title or url must be provided');
+    }
+    const currentUrl = this.getCurrentUrl();
+    const contexts = lodash_1.default.filter(await this.getContextsAndViews(false), 'view');
+    // first try to match by current url
+    if (currentUrl) {
+        const ctx = contexts.find(({ view }) => (view?.url || '') === currentUrl);
+        if (ctx) {
+            return ctx.id;
+        }
+    }
+    // if not, try to match by regular expression
+    return contexts.find(({ view }) => (view?.title && titleRegExp?.test(view.title)) || (view?.url && urlRegExp?.test(view.url)))?.id;
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {boolean}
+ */
+function isWebContext() {
+    return !!this.curContext && this.curContext !== utils_1.NATIVE_WIN;
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {boolean}
+ */
+function isWebview() {
+    return this.isWebContext();
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<RemoteDebugger>}
+ */
+async function getNewRemoteDebugger() {
+    const socketPath = this.isRealDevice()
+        ? undefined
+        : (await /** @type {import('../driver').Simulator} */ (this.device).getWebInspectorSocket() ?? undefined);
+    return (0, appium_remote_debugger_1.createRemoteDebugger)({
+        bundleId: this.opts.bundleId,
+        additionalBundleIds: this.opts.additionalWebviewBundleIds,
+        isSafari: this.isSafari(),
+        includeSafari: this.opts.includeSafariInWebviews,
+        pageLoadMs: this.pageLoadMs,
+        platformVersion: this.opts.platformVersion,
+        socketPath,
+        remoteDebugProxy: this.opts.remoteDebugProxy,
+        garbageCollectOnExecute: support_1.util.hasValue(this.opts.safariGarbageCollect)
+            ? !!this.opts.safariGarbageCollect
+            : false,
+        udid: this.opts.udid,
+        logAllCommunication: this.opts.safariLogAllCommunication,
+        logAllCommunicationHexDump: this.opts.safariLogAllCommunicationHexDump,
+        socketChunkSize: this.opts.safariSocketChunkSize,
+        webInspectorMaxFrameLength: this.opts.safariWebInspectorMaxFrameLength,
+        pageLoadStrategy: this.caps.pageLoadStrategy,
+    }, this.isRealDevice());
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<string>}
+ */
+async function getCurrentContext() {
+    if (this.curContext && this.curContext !== utils_1.NATIVE_WIN) {
+        return `${WEBVIEW_BASE}${this.curContext}`;
+    }
+    return utils_1.NATIVE_WIN;
+}
+/**
+ * Set context
+ *
+ * @param {string|Context} name - The name of context to set. It could be 'null' as NATIVE_WIN.
+ * @param {any} [callback] The callback. (It is not called in this method)
+ * @param {boolean} [skipReadyCheck=false] - Whether it waits for the new context is ready
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ */
+async function setContext(name, callback, skipReadyCheck = false) {
+    function alreadyInContext(desired, current) {
+        return (desired === current ||
+            (desired === null && current === utils_1.NATIVE_WIN) ||
+            (desired === utils_1.NATIVE_WIN && current === null));
+    }
+    function isNativeContext(context) {
+        return context === utils_1.NATIVE_WIN || context === null;
+    }
+    // allow the full context list to be passed in
+    const strName = String(typeof name === 'object' && name.id ? name.id : name);
+    this.log.debug(`Attempting to set context to '${strName || utils_1.NATIVE_WIN}' from '${this.curContext ? this.curContext : utils_1.NATIVE_WIN}'`);
+    if (alreadyInContext(strName, this.curContext) ||
+        alreadyInContext(lodash_1.default.replace(strName, WEBVIEW_BASE, ''), this.curContext)) {
+        // already in the named context, no need to do anything
+        this.log.debug(`Already in '${strName || utils_1.NATIVE_WIN}' context. Doing nothing.`);
+        return;
+    }
+    if (isNativeContext(strName)) {
+        // switching into the native context
+        this.curContext = null;
+        await notifyBiDiContextChange.bind(this)();
+        return;
+    }
+    // switching into a webview context
+    // if contexts have not already been retrieved, get them
+    if (lodash_1.default.isUndefined(this.contexts)) {
+        await this.getContexts();
+    }
+    let contextId = lodash_1.default.replace(strName, WEBVIEW_BASE, '');
+    if (contextId === '') {
+        // allow user to pass in "WEBVIEW" without an index
+        // the second context will be the first webview as
+        // the first is always NATIVE_APP
+        contextId = /** @type {string[]} */ (this.contexts)[1];
+    }
+    if (!lodash_1.default.includes(this.contexts, contextId)) {
+        throw new driver_1.errors.NoSuchContextError();
+    }
+    const oldContext = this.curContext;
+    this.curContext = this.curWindowHandle = contextId;
+    // `contextId` will be in the form of `appId.pageId` in this case
+    const [appIdKey, pageIdKey] = lodash_1.default.map(contextId.split('.'), (id) => parseInt(id, 10));
+    try {
+        this.selectingNewPage = true;
+        await ( /** @type {RemoteDebugger} */(this.remote)).selectPage(appIdKey, pageIdKey, skipReadyCheck);
+        await notifyBiDiContextChange.bind(this)();
+    }
+    catch (err) {
+        this.curContext = this.curWindowHandle = oldContext;
+        throw err;
+    }
+    finally {
+        this.selectingNewPage = false;
+    }
+    // attempt to start performance logging, if requested
+    if (this.opts.enablePerformanceLogging && this.remote) {
+        const context = this.curContext;
+        this.log.debug(`Starting performance log on '${context}'`);
+        [this.logs.performance,] = log_1.assignBiDiLogListener.bind(this)(new ios_performance_log_1.IOSPerformanceLog({
+            remoteDebugger: this.remote,
+            log: this.log,
+        }), {
+            type: 'performance',
+            context,
+        });
+        await this.logs.performance?.startCapture();
+    }
+    // start safari logging if the logs handlers are active
+    if (name && name !== utils_1.NATIVE_WIN && this.logs) {
+        if (this.logs.safariConsole) {
+            ( /** @type {RemoteDebugger} */(this.remote)).startConsole(this.logs.safariConsole.onConsoleLogEvent.bind(this.logs.safariConsole));
+        }
+        if (this.logs.safariNetwork) {
+            ( /** @type {RemoteDebugger} */(this.remote)).startNetwork(this.logs.safariNetwork.onNetworkEvent.bind(this.logs.safariNetwork));
+        }
+    }
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<string[]|FullContext[]>}
+ */
+async function getContexts() {
+    this.log.debug('Getting list of available contexts');
+    const contexts = await this.getContextsAndViews(false);
+    if (this.opts.fullContextList) {
+        return /** @type {import('./types').FullContext[]} */ (contexts.map((context) => ({
+            id: context.id.toString(),
+            title: context.view?.title,
+            url: context.view?.url,
+            bundleId: context.view?.bundleId,
+        })));
+    }
+    return /** @type {string[]} */ (contexts.map((context) => context.id.toString()));
+}
+/**
+ * @this {XCUITestDriver}
+ * @param {string} name
+ * @param {boolean} [skipReadyCheck]
+ * @returns {Promise<void>}
+ */
+async function setWindow(name, skipReadyCheck) {
+    if (!this.isWebContext()) {
+        // https://github.com/appium/appium/issues/20710
+        return;
+    }
+    try {
+        await this.setContext(name, lodash_1.default.noop, skipReadyCheck);
+    }
+    catch (err) {
+        // translate the error in terms of windows
+        throw (0, driver_1.isErrorType)(err, driver_1.errors.NoSuchContextError) ? new driver_1.errors.NoSuchWindowError() : err;
+    }
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<string>}
+ */
+async function getWindowHandle() {
+    if (!this.isWebContext()) {
+        // https://github.com/appium/appium/issues/20710
+        return DEFAULT_NATIVE_WINDOW_HANDLE;
+    }
+    if (!this.curContext) {
+        throw new driver_1.errors.InvalidContextError();
+    }
+    this.log.debug(`Getting current window handle`);
+    return this.curContext;
+}
+/**
+ * @this {XCUITestDriver}
+ * @returns {Promise<string[]>}
+ */
+async function getWindowHandles() {
+    if (!this.isWebContext()) {
+        // https://github.com/appium/appium/issues/20710
+        return [DEFAULT_NATIVE_WINDOW_HANDLE];
+    }
+    this.log.debug('Getting list of available window handles');
+    const contexts = await this.getContextsAndViews(false);
+    return (contexts
+        // get rid of the native app context
+        .filter((context) => context.id !== utils_1.NATIVE_WIN)
+        // get the `app.id` format expected
+        .map((context) => 
+    // This is non-nullable because the `FullContext` having `id` `NATIVE_WIN`
+    // _looks like_ the only with an empty view.
+    context.view?.id?.toString() ?? ''));
+}
+/**
+ * Checks if a URL is blacklisted in the 'safariIgnoreWebHostnames' capability
+ *
+ * @param {string} url
+ * @param {string} [safariIgnoreWebHostnames]
+ * @returns {boolean}
+ */
+function isUrlIgnored(url, safariIgnoreWebHostnames) {
+    if (!safariIgnoreWebHostnames || lodash_1.default.isEmpty(safariIgnoreWebHostnames)) {
+        return false;
+    }
+    const ignoredHosts = safariIgnoreWebHostnames
+        .split(',')
+        .map((b) => b.trim())
+        .filter((b) => !lodash_1.default.isEmpty(b));
+    for (const ignoredHost of ignoredHosts) {
+        if (ignoredHost === 'about:blank' && url === 'about:blank') {
+            return true;
+        }
+        else {
+            try {
+                const hostname = new URL(url).hostname;
+                if (hostname === ignoredHost) {
+                    return true;
+                }
+            }
+            catch {
+                // do nothing if invalid URL
+            }
+        }
+    }
+    return false;
+}
+/**
+ * https://github.com/appium/appium/issues/20741
+ *
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ */
+async function notifyBiDiContextChange() {
+    const name = await this.getCurrentContext();
+    this.eventEmitter.emit(constants_1.BIDI_EVENT_NAME, (0, models_1.makeContextUpdatedEvent)(name));
+    this.eventEmitter.emit(constants_1.BIDI_EVENT_NAME, (0, models_1.makeObsoleteContextUpdatedEvent)(name));
+}
+/**
+ * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
+ * @typedef {import('./types').Context} Context
+ * @typedef {import('./types').FullContext} FullContext
+ */
+//# sourceMappingURL=context.js.map

package/build/lib/commands/context.js.map

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

package/build/lib/commands/deviceInfo.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the miscellaneous information about the device under test.
+ *
+ * Since XCUITest driver v4.2.0, this includes device information via lockdown in a real device.
+ *
+ * @returns {Promise<DeviceInfo | (DeviceInfo & LockdownInfo)>} The response of `/wda/device/info'`
+ * @this {import('../driver').XCUITestDriver}
+ */
+export function mobileGetDeviceInfo(this: import("../driver").XCUITestDriver): Promise<DeviceInfo | (DeviceInfo & LockdownInfo)>;
+export type DeviceInfo = import("./types").DeviceInfo;
+export type LockdownInfo = import("./types").LockdownInfo;
+//# sourceMappingURL=deviceInfo.d.ts.map

package/build/lib/commands/deviceInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../../../lib/commands/deviceInfo.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,+EAHa,OAAO,CAAC,UAAU,GAAG,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC,CAc7D;yBAGY,OAAO,SAAS,EAAE,UAAU;2BAC5B,OAAO,SAAS,EAAE,YAAY"}