appium-xcuitest-driver 10.2.2 → 10.4.0

package/build/lib/real-device-clients/devicectl.js

@@ -1,264 +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.Devicectl = void 0;
-const teen_process_1 = require("teen_process");
-const support_1 = require("appium/support");
-const lodash_1 = __importDefault(require("lodash"));
-const XCRUN = 'xcrun';
-/**
- * @typedef {Object} ProcessInfo
- * @property {number} processIdentifier
- * @property {string} executable
- */
-/*
-  Example:
-    {
-      "executable" : "file:///sbin/launchd",
-      "processIdentifier" : 1
-    },
-*/
-/**
- * @typedef {Object} AppInfo
- * @property {boolean} appClip
- * @property {boolean} builtByDeveloper
- * @property {string} bundleIdentifier
- * @property {string} bundleVersion
- * @property {boolean} defaultApp
- * @property {boolean} hidden
- * @property {boolean} internalApp
- * @property {string} name
- * @property {boolean} removable
- * @property {string} url
- * @property {string} version
- */
-/*
-  Example:
-    {
-      "appClip" : false,
-      "builtByDeveloper" : false,
-      "bundleIdentifier" : "com.apple.mobilesafari",
-      "bundleVersion" : "8617.1.17.10.9",
-      "defaultApp" : true,
-      "hidden" : false,
-      "internalApp" : false,
-      "name" : "Safari",
-      "removable" : false,
-      "url" : "file:///Applications/MobileSafari.app/",
-      "version" : "17.2"
-    }
-*/
-/**
- * @typedef {Object} ExecuteOptions
- * @property {boolean} [logStdout=false]
- * @property {boolean} [asJson=true]
- * @property {boolean} [asynchronous=false]
- * @property {string[]|string} [subcommandOptions]
- * @property {number} [timeout]
- */
-/**
- * @typedef {{asynchronous: true}} TAsyncOpts
- */
-/**
- * @typedef {Object} ListFilesOptions
- * @property {string} [username] The username of the user we should target. Only relevant for certain domains.
- * @property {string} [subdirectory] A subdirectory within the domain. If not specified, defaults to the root.
- */
-/**
- * @typedef {Object} PullFileOptions
- * @property {string} [username] The username of the user we should target. Only relevant for certain domains.
- * @property {string} domainType The file service domain. Valid values are: temporary, rootStaging, appDataContainer, appGroupDataContainer,
- * systemCrashLogs. You must specify a valid domain and identifier pair. Each domain is accompanied by an identifier
- * that provides additional context. For example, if the domain is an app data container, the identifier is the bundle
- * ID of the app. For temporary directories and root staging areas, the identifier is a unique client-provided string
- * which is used to get your own space, separate from those of other clients.
- * @property {string} domainIdentifier A unique string used to provide additional context to the domain.
- * @property {number} [timeout=120000] The timeout for pulling a file in milliseconds.
- */
-/**
- * An option for launchApp method by devicectl.
- * @typedef {Object} LaunchAppOptions
- * @property {import('@appium/types').StringRecord<string|number>} [env] Bundle id to Environment variables for the launching app process.
- * @property {boolean} [terminateExisting=false] Whether terminating the already running app.
- */
-class Devicectl {
-    /**
-     * @since Xcode 15, iOS 17
-     * @param {string} udid
-     * @param {import('@appium/types').AppiumLogger} log
-     */
-    constructor(udid, log) {
-        this.udid = udid;
-        this.log = log;
-    }
-    /**
-     * @template {ExecuteOptions} TExecOpts
-     * @param {string[]} subcommand
-     * @param {TExecOpts} [opts]
-     * @return {Promise<TExecOpts extends TAsyncOpts ? import('teen_process').SubProcess : import('teen_process').TeenProcessExecResult>}
-     */
-    async execute(subcommand, opts) {
-        const { logStdout = false, asynchronous = false, asJson = true, subcommandOptions, timeout, } = opts ?? {};
-        const finalArgs = [
-            'devicectl', ...subcommand,
-            '--device', this.udid,
-        ];
-        if (subcommandOptions && !lodash_1.default.isEmpty(subcommandOptions)) {
-            finalArgs.push(...(Array.isArray(subcommandOptions) ? subcommandOptions : [subcommandOptions]));
-        }
-        if (asJson) {
-            finalArgs.push('--quiet', '--json-output', '-');
-        }
-        const cmdStr = support_1.util.quote([XCRUN, ...finalArgs]);
-        this.log.debug(`Executing ${cmdStr}`);
-        try {
-            if (asynchronous) {
-                const result = new teen_process_1.SubProcess(XCRUN, finalArgs);
-                await result.start(0);
-                // @ts-ignore TS does not understand it
-                return result;
-            }
-            const result = await (0, teen_process_1.exec)(XCRUN, finalArgs, ...(lodash_1.default.isNumber(timeout) ? [{ timeout }] : []));
-            if (logStdout) {
-                this.log.debug(`Command output: ${result.stdout}`);
-            }
-            // @ts-ignore TS does not understand it
-            return result;
-        }
-        catch (e) {
-            throw new Error(`'${cmdStr}' failed. Original error: ${e.stderr || e.stdout || e.message}`);
-        }
-    }
-    /**
-     * Simulates memory warning for the process with the given PID
-     *
-     * @param {number|string} pid The process identifier to simulate the Low Memory warning for
-     * @return {Promise<void>}
-     */
-    async sendMemoryWarning(pid) {
-        await this.execute(['device', 'process', 'sendMemoryWarning'], {
-            subcommandOptions: ['--pid', `${pid}`]
-        });
-    }
-    /**
-     * Lists running processes on the device
-     *
-     * @returns {Promise<ProcessInfo[]>}
-     */
-    async listProcesses() {
-        const { stdout } = await this.execute(['device', 'info', 'processes']);
-        return JSON.parse(stdout).result.runningProcesses;
-    }
-    /**
-     * Lists files at a specified path on the device
-     *
-     * @param {string} domainType The file service domain. Valid values are: temporary, rootStaging, appDataContainer, appGroupDataContainer,
-     * systemCrashLogs. You must specify a valid domain and identifier pair. Each domain is accompanied by an identifier
-     * that provides additional context. For example, if the domain is an app data container, the identifier is the bundle
-     * ID of the app. For temporary directories and root staging areas, the identifier is a unique client-provided string
-     * which is used to get your own space, separate from those of other clients.
-     * @param {string} domainIdentifier A unique string used to provide additional context to the domain.
-     * @param {ListFilesOptions} [opts={}]
-     * @returns {Promise<string[]>} List of file names (could be empty)
-     */
-    async listFiles(domainType, domainIdentifier, opts = {}) {
-        const subcommandOptions = [
-            '--domain-type', domainType,
-            '--domain-identifier', domainIdentifier,
-        ];
-        if (opts.username) {
-            subcommandOptions.push('--username', opts.username);
-        }
-        if (opts.subdirectory) {
-            subcommandOptions.push('--subdirectory', opts.subdirectory);
-        }
-        const { stdout } = await this.execute(['device', 'info', 'files'], {
-            subcommandOptions,
-        });
-        return JSON.parse(stdout).result.files.map(({ name }) => name);
-    }
-    /**
-     * Pulls a file from the specified path on the device to a local file system
-     *
-     * @param {string} from The item which should be copied.
-     * @param {string} to The location to which the item should be copied.
-     * @param {PullFileOptions} opts
-     * @returns {Promise<string>} The destination path (same as `to`)
-     */
-    async pullFile(from, to, opts) {
-        const subcommandOptions = [
-            '--domain-type', opts.domainType,
-            '--domain-identifier', opts.domainIdentifier,
-            '--source', from,
-            '--destination', to,
-        ];
-        if (opts.username) {
-            subcommandOptions.push('--user', opts.username);
-        }
-        await this.execute(['device', 'copy', 'from'], {
-            subcommandOptions,
-            timeout: opts.timeout ?? 120000,
-            asJson: false,
-        });
-        return to;
-    }
-    /**
-     * Send POSIX signal to the running process
-     *
-     * @param {number|string} pid The process identifier to send a signal to
-     * @param {number|string} signal The signal to send to a process. See 'man signal' for a list of signals
-     * @returns {Promise<void>}
-     */
-    async sendSignalToProcess(pid, signal) {
-        await this.execute(['device', 'process', 'signal'], {
-            subcommandOptions: ['--signal', `${signal}`, '--pid', `${pid}`]
-        });
-    }
-    /**
-     * Retrieves the list of installed apps from the device
-     *
-     * @param {string?} [bundleId=null] Provide the target bundle identifier
-     * to speed up the lookup.
-     * @returns {Promise<AppInfo[]>} Empty array is returned if no matching apps are found
-     */
-    async listApps(bundleId = null) {
-        const subcommandOptions = ['--include-all-apps'];
-        if (bundleId) {
-            subcommandOptions.push('--bundle-id', bundleId);
-        }
-        const { stdout } = await this.execute(['device', 'info', 'apps'], {
-            subcommandOptions,
-        });
-        return JSON.parse(stdout).result.apps;
-    }
-    /**
-     * Launch the given bundle id application with the given environment variable.
-     * This method is over devicectl command, this it may take additional seconds to launch the app.
-     * Please use via WDA or via appium-ios-device as primary method to launch app if possible.
-     *
-     * @param {string} bundleId Bundle id to launch.
-     * @param {LaunchAppOptions} opts launching app with devicectl command options.
-     * @returns {Promise<void>}
-     * @throws {Error} If the launching app command fails. For example, the given bundle id did not exist.
-     */
-    async launchApp(bundleId, opts) {
-        const { env, terminateExisting = false } = opts;
-        const subcommandOptions = [];
-        if (terminateExisting) {
-            subcommandOptions.push('--terminate-existing');
-        }
-        ;
-        if (!lodash_1.default.isEmpty(env)) {
-            subcommandOptions.push('--environment-variables', JSON.stringify(lodash_1.default.mapValues(env, (v) => lodash_1.default.toString(v))));
-        }
-        ;
-        // The bundle id should be the last to apply arguments properly.
-        // devicectl command might not raise exception while the order is wrong.
-        subcommandOptions.push(bundleId);
-        await this.execute(['device', 'process', 'launch'], { subcommandOptions, asJson: false });
-    }
-}
-exports.Devicectl = Devicectl;
-//# sourceMappingURL=devicectl.js.map

package/build/lib/real-device-clients/devicectl.js.map

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

package/lib/commands/activeAppInfo.js

@@ -1,14 +0,0 @@
-export default {
-  /**
-   * Returns information about the active application.
-   *
-   * @returns {Promise<import('./types').ActiveAppInfo>} Active app information
-   * @throws {Error} if an error raised by command
-   * @this {import('../driver').XCUITestDriver}
-   */
-  async mobileGetActiveAppInfo() {
-    return /** @type {import('./types').ActiveAppInfo} */ (
-      await this.proxyCommand('/wda/activeAppInfo', 'GET')
-    );
-  },
-};

package/lib/commands/index.js

@@ -1,95 +0,0 @@
-import activeAppInfoExtensions from './activeAppInfo';
-import alertExtensions from './alert';
-import appManagementExtensions from './app-management';
-import appearanceExtensions from './appearance';
-import appStringsExtensions from './app-strings';
-import auditExtensions from './audit';
-import batteryExtensions from './battery';
-import biometricExtensions from './biometric';
-import certificateExtensions from './certificate';
-import clipboardExtensions from './clipboard';
-import conditionExtensions from './condition';
-import contentSizeExtensions from './content-size';
-import contextExtensions from './context';
-import deviceInfoExtensions from './deviceInfo';
-import elementExtensions from './element';
-import executeExtensions from './execute';
-import fileMovementExtensions from './file-movement';
-import findExtensions from './find';
-import generalExtensions from './general';
-import geolocationExtensions from './geolocation';
-import gestureExtensions from './gesture';
-import increaseContrastExtensions from './increase-contrast';
-import iohidExtensions from './iohid';
-import keychainsExtensions from './keychains';
-import keyboardExtensions from './keyboard';
-import localizationExtensions from './localization';
-import locationExtensions from './location';
-import lockExtensions from './lock';
-import logExtensions from './log';
-import memoryExtensions from './memory';
-import navigationExtensions from './navigation';
-import notificationsExtensions from './notifications';
-import pasteboardExtensions from './pasteboard';
-import pcapExtensions from './pcap';
-import performanceExtensions from './performance';
-import permissionsExtensions from './permissions';
-import proxyHelperExtensions from './proxy-helper';
-import recordAudioExtensions from './record-audio';
-import recordScreenExtensions from './recordscreen';
-import screenshotExtensions from './screenshots';
-import sourceExtensions from './source';
-import simctl from './simctl';
-import timeoutExtensions from './timeouts';
-import webExtensions from './web';
-import xctestExtensions from './xctest';
-import xctestRecordScreenExtensions from './xctest-record-screen';
-
-export default {
-  activeAppInfoExtensions,
-  alertExtensions,
-  appearanceExtensions,
-  appManagementExtensions,
-  appStringsExtensions,
-  auditExtensions,
-  batteryExtensions,
-  biometricExtensions,
-  certificateExtensions,
-  clipboardExtensions,
-  conditionExtensions,
-  contentSizeExtensions,
-  contextExtensions,
-  deviceInfoExtensions,
-  elementExtensions,
-  executeExtensions,
-  fileMovementExtensions,
-  findExtensions,
-  generalExtensions,
-  geolocationExtensions,
-  gestureExtensions,
-  increaseContrastExtensions,
-  iohidExtensions,
-  keychainsExtensions,
-  keyboardExtensions,
-  localizationExtensions,
-  locationExtensions,
-  lockExtensions,
-  logExtensions,
-  memoryExtensions,
-  navigationExtensions,
-  notificationsExtensions,
-  pasteboardExtensions,
-  pcapExtensions,
-  performanceExtensions,
-  permissionsExtensions,
-  proxyHelperExtensions,
-  recordAudioExtensions,
-  recordScreenExtensions,
-  simctl,
-  screenshotExtensions,
-  sourceExtensions,
-  timeoutExtensions,
-  webExtensions,
-  xctestExtensions,
-  xctestRecordScreenExtensions,
-};

package/lib/real-device-clients/devicectl.js

@@ -1,291 +0,0 @@
-import {exec, SubProcess} from 'teen_process';
-import {util} from 'appium/support';
-import _ from 'lodash';
-
-const XCRUN = 'xcrun';
-
-/**
- * @typedef {Object} ProcessInfo
- * @property {number} processIdentifier
- * @property {string} executable
- */
-
-/*
-  Example:
-    {
-      "executable" : "file:///sbin/launchd",
-      "processIdentifier" : 1
-    },
-*/
-
-/**
- * @typedef {Object} AppInfo
- * @property {boolean} appClip
- * @property {boolean} builtByDeveloper
- * @property {string} bundleIdentifier
- * @property {string} bundleVersion
- * @property {boolean} defaultApp
- * @property {boolean} hidden
- * @property {boolean} internalApp
- * @property {string} name
- * @property {boolean} removable
- * @property {string} url
- * @property {string} version
- */
-
-/*
-  Example:
-    {
-      "appClip" : false,
-      "builtByDeveloper" : false,
-      "bundleIdentifier" : "com.apple.mobilesafari",
-      "bundleVersion" : "8617.1.17.10.9",
-      "defaultApp" : true,
-      "hidden" : false,
-      "internalApp" : false,
-      "name" : "Safari",
-      "removable" : false,
-      "url" : "file:///Applications/MobileSafari.app/",
-      "version" : "17.2"
-    }
-*/
-
-/**
- * @typedef {Object} ExecuteOptions
- * @property {boolean} [logStdout=false]
- * @property {boolean} [asJson=true]
- * @property {boolean} [asynchronous=false]
- * @property {string[]|string} [subcommandOptions]
- * @property {number} [timeout]
- */
-
-/**
- * @typedef {{asynchronous: true}} TAsyncOpts
- */
-
-/**
- * @typedef {Object} ListFilesOptions
- * @property {string} [username] The username of the user we should target. Only relevant for certain domains.
- * @property {string} [subdirectory] A subdirectory within the domain. If not specified, defaults to the root.
- */
-
-/**
- * @typedef {Object} PullFileOptions
- * @property {string} [username] The username of the user we should target. Only relevant for certain domains.
- * @property {string} domainType The file service domain. Valid values are: temporary, rootStaging, appDataContainer, appGroupDataContainer,
- * systemCrashLogs. You must specify a valid domain and identifier pair. Each domain is accompanied by an identifier
- * that provides additional context. For example, if the domain is an app data container, the identifier is the bundle
- * ID of the app. For temporary directories and root staging areas, the identifier is a unique client-provided string
- * which is used to get your own space, separate from those of other clients.
- * @property {string} domainIdentifier A unique string used to provide additional context to the domain.
- * @property {number} [timeout=120000] The timeout for pulling a file in milliseconds.
- */
-
-
-/**
- * An option for launchApp method by devicectl.
- * @typedef {Object} LaunchAppOptions
- * @property {import('@appium/types').StringRecord<string|number>} [env] Bundle id to Environment variables for the launching app process.
- * @property {boolean} [terminateExisting=false] Whether terminating the already running app.
- */
-
-export class Devicectl {
-  /**
-   * @since Xcode 15, iOS 17
-   * @param {string} udid
-   * @param {import('@appium/types').AppiumLogger} log
-   */
-  constructor(udid, log) {
-    this.udid = udid;
-    this.log = log;
-  }
-
-  /**
-   * @template {ExecuteOptions} TExecOpts
-   * @param {string[]} subcommand
-   * @param {TExecOpts} [opts]
-   * @return {Promise<TExecOpts extends TAsyncOpts ? import('teen_process').SubProcess : import('teen_process').TeenProcessExecResult>}
-   */
-  async execute(subcommand, opts) {
-    const {
-      logStdout = false,
-      asynchronous = false,
-      asJson = true,
-      subcommandOptions,
-      timeout,
-    } = opts ?? {};
-
-    const finalArgs = [
-      'devicectl', ...subcommand,
-      '--device', this.udid,
-    ];
-    if (subcommandOptions && !_.isEmpty(subcommandOptions)) {
-      finalArgs.push(
-        ...(Array.isArray(subcommandOptions) ? subcommandOptions : [subcommandOptions])
-      );
-    }
-    if (asJson) {
-      finalArgs.push('--quiet', '--json-output', '-');
-    }
-    const cmdStr = util.quote([XCRUN, ...finalArgs]);
-    this.log.debug(`Executing ${cmdStr}`);
-    try {
-      if (asynchronous) {
-        const result = new SubProcess(XCRUN, finalArgs);
-        await result.start(0);
-        // @ts-ignore TS does not understand it
-        return result;
-      }
-      const result = await exec(
-        XCRUN,
-        finalArgs,
-        ...(_.isNumber(timeout) ? [{timeout}] : []),
-      );
-      if (logStdout) {
-        this.log.debug(`Command output: ${result.stdout}`);
-      }
-      // @ts-ignore TS does not understand it
-      return result;
-    } catch (e) {
-      throw new Error(`'${cmdStr}' failed. Original error: ${e.stderr || e.stdout || e.message}`);
-    }
-  }
-
-  /**
-   * Simulates memory warning for the process with the given PID
-   *
-   * @param {number|string} pid The process identifier to simulate the Low Memory warning for
-   * @return {Promise<void>}
-   */
-  async sendMemoryWarning(pid) {
-    await this.execute(['device', 'process', 'sendMemoryWarning'], {
-      subcommandOptions: ['--pid', `${pid}`]
-    });
-  }
-
-  /**
-   * Lists running processes on the device
-   *
-   * @returns {Promise<ProcessInfo[]>}
-   */
-  async listProcesses() {
-    const {stdout} = await this.execute(['device', 'info', 'processes']);
-    return JSON.parse(stdout).result.runningProcesses;
-  }
-
-  /**
-   * Lists files at a specified path on the device
-   *
-   * @param {string} domainType The file service domain. Valid values are: temporary, rootStaging, appDataContainer, appGroupDataContainer,
-   * systemCrashLogs. You must specify a valid domain and identifier pair. Each domain is accompanied by an identifier
-   * that provides additional context. For example, if the domain is an app data container, the identifier is the bundle
-   * ID of the app. For temporary directories and root staging areas, the identifier is a unique client-provided string
-   * which is used to get your own space, separate from those of other clients.
-   * @param {string} domainIdentifier A unique string used to provide additional context to the domain.
-   * @param {ListFilesOptions} [opts={}]
-   * @returns {Promise<string[]>} List of file names (could be empty)
-   */
-  async listFiles(domainType, domainIdentifier, opts = {}) {
-    const subcommandOptions = [
-      '--domain-type', domainType,
-      '--domain-identifier', domainIdentifier,
-    ];
-    if (opts.username) {
-      subcommandOptions.push('--username', opts.username);
-    }
-    if (opts.subdirectory) {
-      subcommandOptions.push('--subdirectory', opts.subdirectory);
-    }
-    const {stdout} = await this.execute(['device', 'info', 'files'], {
-      subcommandOptions,
-    });
-    return JSON.parse(stdout).result.files.map(({name}) => name);
-  }
-
-  /**
-   * Pulls a file from the specified path on the device to a local file system
-   *
-   * @param {string} from The item which should be copied.
-   * @param {string} to The location to which the item should be copied.
-   * @param {PullFileOptions} opts
-   * @returns {Promise<string>} The destination path (same as `to`)
-   */
-  async pullFile(from, to, opts) {
-    const subcommandOptions = [
-      '--domain-type', opts.domainType,
-      '--domain-identifier', opts.domainIdentifier,
-      '--source', from,
-      '--destination', to,
-    ];
-    if (opts.username) {
-      subcommandOptions.push('--user', opts.username);
-    }
-    await this.execute(['device', 'copy', 'from'], {
-      subcommandOptions,
-      timeout: opts.timeout ?? 120000,
-      asJson: false,
-    });
-    return to;
-  }
-
-  /**
-   * Send POSIX signal to the running process
-   *
-   * @param {number|string} pid The process identifier to send a signal to
-   * @param {number|string} signal The signal to send to a process. See 'man signal' for a list of signals
-   * @returns {Promise<void>}
-   */
-  async sendSignalToProcess(pid, signal) {
-    await this.execute(['device', 'process', 'signal'], {
-      subcommandOptions: ['--signal', `${signal}`, '--pid', `${pid}`]
-    });
-  }
-
-  /**
-   * Retrieves the list of installed apps from the device
-   *
-   * @param {string?} [bundleId=null] Provide the target bundle identifier
-   * to speed up the lookup.
-   * @returns {Promise<AppInfo[]>} Empty array is returned if no matching apps are found
-   */
-  async listApps(bundleId = null) {
-    const subcommandOptions = ['--include-all-apps'];
-    if (bundleId) {
-      subcommandOptions.push('--bundle-id', bundleId);
-    }
-    const {stdout} = await this.execute(['device', 'info', 'apps'], {
-      subcommandOptions,
-    });
-    return JSON.parse(stdout).result.apps;
-  }
-
-  /**
-   * Launch the given bundle id application with the given environment variable.
-   * This method is over devicectl command, this it may take additional seconds to launch the app.
-   * Please use via WDA or via appium-ios-device as primary method to launch app if possible.
-   *
-   * @param {string} bundleId Bundle id to launch.
-   * @param {LaunchAppOptions} opts launching app with devicectl command options.
-   * @returns {Promise<void>}
-   * @throws {Error} If the launching app command fails. For example, the given bundle id did not exist.
-   */
-  async launchApp(bundleId, opts) {
-    const {
-      env,
-      terminateExisting = false
-    } = opts;
-
-    const subcommandOptions = [];
-    if (terminateExisting) {
-      subcommandOptions.push('--terminate-existing');
-    };
-    if (!_.isEmpty(env)) {
-      subcommandOptions.push('--environment-variables', JSON.stringify(_.mapValues(env, (v) => _.toString(v))));
-    };
-    // The bundle id should be the last to apply arguments properly.
-    // devicectl command might not raise exception while the order is wrong.
-    subcommandOptions.push(bundleId);
-
-    await this.execute(['device', 'process', 'launch'], { subcommandOptions, asJson: false});
-  }
-}