@limrun/appium-xcuitest-driver 10.11.0-lim.4 → 10.14.6-lim.1

package/build/lib/commands/general.js

@@ -27,7 +27,12 @@ const appium_ios_device_1 = require("appium-ios-device");
 const teen_process_1 = require("teen_process");
 const MOMENT_FORMAT_ISO8601 = 'YYYY-MM-DDTHH:mm:ssZ';
 /**
- * @this {XCUITestDriver}
+ * Gets the currently active element.
+ *
+ * In web context, returns the active element from the DOM.
+ * In native context, returns the active element from the current view.
+ *
+ * @returns The active element
  */
 async function active() {
     if (this.isWebContext()) {
@@ -36,28 +41,25 @@ async function active() {
     return await this.proxyCommand(`/element/active`, 'GET');
 }
 /**
- * Trigger a touch/fingerprint match or match failure
+ * Trigger a touch/fingerprint match or match failure.
  *
- * @param {boolean} match - whether the match should be a success or failure
- * @this {XCUITestDriver}
+ * @param match - Whether the match should be a success or failure
  */
 async function touchId(match = true) {
     await this.mobileSendBiometricMatch('touchId', match);
 }
 /**
- * Toggle whether the device is enrolled in the touch ID program
- *
- * @param {boolean} isEnabled - whether to enable or disable the touch ID program
+ * Toggle whether the device is enrolled in the touch ID program.
  *
- * @this {XCUITestDriver}
+ * @param isEnabled - Whether to enable or disable the touch ID program
  */
 async function toggleEnrollTouchId(isEnabled = true) {
     await this.mobileEnrollBiometric(isEnabled);
 }
 /**
- * Get the window size
- * @this {XCUITestDriver}
- * @returns {Promise<import('@appium/types').Size>}
+ * Get the window size.
+ *
+ * @returns The window size (width and height)
  */
 async function getWindowSize() {
     const { width, height } = await this.getWindowRect();
@@ -66,9 +68,8 @@ async function getWindowSize() {
 /**
  * Retrieves the actual device time.
  *
- * @param {string} format - The format specifier string. Read the [MomentJS documentation](https://momentjs.com/docs/) to get the full list of supported datetime format specifiers. The default format is `YYYY-MM-DDTHH:mm:ssZ`, which complies to ISO-8601.
- * @returns {Promise<string>} Formatted datetime string or the raw command output (if formatting fails)
- * @this {XCUITestDriver}
+ * @param format - The format specifier string. Read the [MomentJS documentation](https://momentjs.com/docs/) to get the full list of supported datetime format specifiers. The default format is `YYYY-MM-DDTHH:mm:ssZ`, which complies to ISO-8601.
+ * @returns Formatted datetime string or the raw command output (if formatting fails)
  */
 async function getDeviceTime(format = MOMENT_FORMAT_ISO8601) {
     this.log.info('Attempting to capture iOS device date and time');
@@ -107,19 +108,23 @@ async function getDeviceTime(format = MOMENT_FORMAT_ISO8601) {
     return utc.format(format);
 }
 /**
- * Retrieves the current device time
+ * Retrieves the current device time.
+ *
+ * This is a wrapper around {@linkcode getDeviceTime}.
  *
- * @param {string} format - See {@linkcode getDeviceTime.format}
- * @returns {Promise<string>} Formatted datetime string or the raw command output if formatting fails
- * @this {XCUITestDriver}
+ * @param format - See {@linkcode getDeviceTime.format}
+ * @returns Formatted datetime string or the raw command output if formatting fails
  */
 async function mobileGetDeviceTime(format = MOMENT_FORMAT_ISO8601) {
     return await this.getDeviceTime(format);
 }
 /**
- * For W3C
- * @this {XCUITestDriver}
- * @return {Promise<import('@appium/types').Rect>}
+ * Gets the window rectangle (position and size).
+ *
+ * For W3C compatibility. In web context, returns the browser window dimensions.
+ * In native context, returns the device window dimensions.
+ *
+ * @returns The window rectangle
  */
 async function getWindowRect() {
     if (this.isWebContext()) {
@@ -131,32 +136,49 @@ async function getWindowRect() {
             '}';
         return await this.executeAtom('execute_script', [script]);
     }
-    return /** @type {import('@appium/types').Rect} */ (await this.proxyCommand('/window/rect', 'GET'));
+    return (await this.proxyCommand('/window/rect', 'GET'));
 }
 /**
- * @this {XCUITestDriver}
+ * Removes/uninstalls the given application from the device under test.
+ *
+ * This is a wrapper around {@linkcode mobileRemoveApp mobile: removeApp}.
+ *
+ * @param bundleId - The bundle identifier of the application to be removed
+ * @returns `true` if the application has been removed successfully; `false` otherwise
  */
 async function removeApp(bundleId) {
     return await this.mobileRemoveApp(bundleId);
 }
 /**
- * @this {XCUITestDriver}
+ * Launches the app.
+ *
+ * @deprecated This API has been deprecated and is not supported anymore.
+ * Consider using corresponding 'mobile:' extensions to manage the state of the app under test.
+ * @throws {Error} Always throws an error indicating the API is deprecated
  */
 async function launchApp() {
     throw new Error(`The launchApp API has been deprecated and is not supported anymore. ` +
         `Consider using corresponding 'mobile:' extensions to manage the state of the app under test.`);
 }
 /**
- * @this {XCUITestDriver}
+ * Closes the app.
+ *
+ * @deprecated This API has been deprecated and is not supported anymore.
+ * Consider using corresponding 'mobile:' extensions to manage the state of the app under test.
+ * @throws {Error} Always throws an error indicating the API is deprecated
  */
 async function closeApp() {
     throw new Error(`The closeApp API has been deprecated and is not supported anymore. ` +
         `Consider using corresponding 'mobile:' extensions to manage the state of the app under test.`);
 }
 /**
- * @this {XCUITestDriver}
- * @param {string} url
- * @returns {Promise<void>}
+ * Sets the URL for the current session.
+ *
+ * In web context, navigates to the URL using the remote debugger.
+ * In native context on real devices, uses the proxy command.
+ * In native context on simulators, uses simctl to open the URL.
+ *
+ * @param url - The URL to navigate to
  */
 async function setUrl(url) {
     this.log.debug(`Attempting to set url '${url}'`);
@@ -164,22 +186,22 @@ async function setUrl(url) {
         this.setCurrentUrl(url);
         // make sure to clear out any leftover web frames
         this.curWebFrames = [];
-        await ( /** @type {import('appium-remote-debugger').RemoteDebugger} */(this.remote)).navToUrl(url);
+        await this.remote.navToUrl(url);
         return;
     }
     if (this.isRealDevice()) {
         await this.proxyCommand('/url', 'POST', { url });
     }
     else {
-        await /** @type {import('appium-ios-simulator').Simulator} */ (this.device).simctl.openUrl(url);
+        await this.device.simctl.openUrl(url);
     }
 }
 /**
  * Retrieves the viewport dimensions.
  *
  * The viewport is the device's screen size with status bar size subtracted if the latter is present/visible.
- * @returns {Promise<import('./types').Viewport>}
- * @this {XCUITestDriver}
+ *
+ * @returns The viewport rectangle
  */
 async function getViewportRect() {
     const scale = await this.getDevicePixelRatio();
@@ -199,22 +221,25 @@ async function getViewportRect() {
  * Get information about the screen.
  *
  * @privateRemarks memoized in constructor
- * @this {XCUITestDriver}
- * @returns {Promise<ScreenInfo>}
+ * @returns Screen information including dimensions, scale, and status bar size
  */
 async function getScreenInfo() {
-    return /** @type {ScreenInfo} */ (await this.proxyCommand('/wda/screen', 'GET'));
+    return (await this.proxyCommand('/wda/screen', 'GET'));
 }
 /**
- * @this {XCUITestDriver}
+ * Gets the status bar height.
+ *
+ * @returns The height of the status bar in logical pixels
  */
 async function getStatusBarHeight() {
     const { statusBarSize } = await this.getScreenInfo();
     return statusBarSize.height;
 }
 /**
- * memoized in constructor
- * @this {XCUITestDriver}
+ * Gets the device pixel ratio.
+ *
+ * @privateRemarks memoized in constructor
+ * @returns The device pixel ratio (scale factor)
  */
 async function getDevicePixelRatio() {
     const { scale } = await this.getScreenInfo();
@@ -230,9 +255,8 @@ async function getDevicePixelRatio() {
  *
  * Use {@linkcode mobilePerformIoHidEvent} to call a more universal API to perform a button press with duration on any supported device.
  *
- * @param {import('./types').ButtonName} name - The name of the button to be pressed.
- * @param {number} [durationSeconds] - The duration of the button press in seconds (float).
- * @this {XCUITestDriver}
+ * @param name - The name of the button to be pressed
+ * @param durationSeconds - The duration of the button press in seconds (float)
  */
 async function mobilePressButton(name, durationSeconds) {
     if (!name) {
@@ -247,10 +271,8 @@ async function mobilePressButton(name, durationSeconds) {
  * Process a string as speech and send it to Siri.
  *
  * Presents the Siri UI, if it is not currently active, and accepts a string which is then processed as if it were recognized speech. See [the documentation of `activateWithVoiceRecognitionText`](https://developer.apple.com/documentation/xctest/xcuisiriservice/2852140-activatewithvoicerecognitiontext?language=objc) for more details.
-
- * @param {string} text - Text to be sent to Siri
- * @returns {Promise<void>}
- * @this {XCUITestDriver}
+ *
+ * @param text - Text to be sent to Siri
  */
 async function mobileSiriCommand(text) {
     if (!text) {
@@ -258,13 +280,4 @@ async function mobileSiriCommand(text) {
     }
     await this.proxyCommand('/wda/siri/activate', 'POST', { text });
 }
-/**
- * @typedef {Object} PressButtonOptions
- * @property {string} name - The name of the button to be pressed.
- * @property {number} [durationSeconds] - Duration in float seconds.
- */
-/**
- * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
- * @typedef {import('./types').ScreenInfo} ScreenInfo
- */
 //# sourceMappingURL=general.js.map

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

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

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

@@ -1,57 +1,37 @@
-/**
- * @typedef {Object} GeolocationInfo
- * @property {number|null} latitude Measurement of distance north or south of the Equator, or
- * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode
- * resetSimulatedLocation} has been called.
- * @property {number|null} longitude Measurement of distance east or west of the prime meridian, or
- * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode
- * resetSimulatedLocation} has been called.
- */
+import type { XCUITestDriver } from '../driver';
+export interface GeolocationInfo {
+    /** Measurement of distance north or south of the Equator, or `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode mobileResetSimulatedLocation} has been called. */
+    latitude: number | null;
+    /** Measurement of distance east or west of the prime meridian, or `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode mobileResetSimulatedLocation} has been called. */
+    longitude: number | null;
+}
 /**
  * Retrieves the simulated geolocation value.
  * Only works since Xcode 14.3/iOS 16.4
  *
- * @returns {Promise<GeolocationInfo>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @returns The current simulated geolocation
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
-export function mobileGetSimulatedLocation(this: import("../driver").XCUITestDriver): Promise<GeolocationInfo>;
+export declare function mobileGetSimulatedLocation(this: XCUITestDriver): Promise<GeolocationInfo>;
 /**
  * Sets simulated geolocation value.
  * Only works since Xcode 14.3/iOS 16.4
  *
- * @param {number} latitude
- * @param {number} longitude
- * @returns {Promise<void>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @param latitude - Latitude value
+ * @param longitude - Longitude value
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
-export function mobileSetSimulatedLocation(this: import("../driver").XCUITestDriver, latitude: number, longitude: number): Promise<void>;
+export declare function mobileSetSimulatedLocation(this: XCUITestDriver, latitude: number, longitude: number): Promise<void>;
 /**
  * Resets simulated geolocation value.
  * Only works since Xcode 14.3/iOS 16.4.
  * ! Do not forget to reset the simulated geolocation value after your automated test is finished.
  * ! If the value is not reset explicitly then the simulated one will remain until the next device restart.
  *
- * @returns {Promise<void>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
-export function mobileResetSimulatedLocation(this: import("../driver").XCUITestDriver): Promise<void>;
-export type GeolocationInfo = {
-    /**
-     * Measurement of distance north or south of the Equator, or
-     * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode  * resetSimulatedLocation} has been called.
-     */
-    latitude: number | null;
-    /**
-     * Measurement of distance east or west of the prime meridian, or
-     * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode  * resetSimulatedLocation} has been called.
-     */
-    longitude: number | null;
-};
-export type XCUITestDriver = import("../driver").XCUITestDriver;
+export declare function mobileResetSimulatedLocation(this: XCUITestDriver): Promise<void>;
 //# sourceMappingURL=geolocation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"geolocation.d.ts","sourceRoot":"","sources":["../../../lib/commands/geolocation.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,sFALa,OAAO,CAAC,eAAe,CAAC,CAOpC;AAED;;;;;;;;;;GAUG;AACH,+FAPW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAOzB;AAED;;;;;;;;;;GAUG;AACH,wFALa,OAAO,CAAC,IAAI,CAAC,CAOzB;;;;;;cAjDa,MAAM,GAAC,IAAI;;;;;eAGX,MAAM,GAAC,IAAI;;6BAiDZ,OAAO,WAAW,EAAE,cAAc"}
+{"version":3,"file":"geolocation.d.ts","sourceRoot":"","sources":["../../../lib/commands/geolocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,iNAAiN;IACjN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sNAAsN;IACtN,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/build/lib/commands/geolocation.js

@@ -1,13 +1,4 @@
 "use strict";
-/**
- * @typedef {Object} GeolocationInfo
- * @property {number|null} latitude Measurement of distance north or south of the Equator, or
- * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode
- * resetSimulatedLocation} has been called.
- * @property {number|null} longitude Measurement of distance east or west of the prime meridian, or
- * `null` if {@linkcode XCUITestDriver.mobileSetSimulatedLocation} has not been called or {@linkcode
- * resetSimulatedLocation} has been called.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mobileGetSimulatedLocation = mobileGetSimulatedLocation;
 exports.mobileSetSimulatedLocation = mobileSetSimulatedLocation;
@@ -16,10 +7,9 @@ exports.mobileResetSimulatedLocation = mobileResetSimulatedLocation;
  * Retrieves the simulated geolocation value.
  * Only works since Xcode 14.3/iOS 16.4
  *
- * @returns {Promise<GeolocationInfo>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @returns The current simulated geolocation
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
 async function mobileGetSimulatedLocation() {
     return await this.proxyCommand('/wda/simulatedLocation', 'GET');
@@ -28,15 +18,13 @@ async function mobileGetSimulatedLocation() {
  * Sets simulated geolocation value.
  * Only works since Xcode 14.3/iOS 16.4
  *
- * @param {number} latitude
- * @param {number} longitude
- * @returns {Promise<void>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @param latitude - Latitude value
+ * @param longitude - Longitude value
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
 async function mobileSetSimulatedLocation(latitude, longitude) {
-    return await this.proxyCommand('/wda/simulatedLocation', 'POST', { latitude, longitude });
+    await this.proxyCommand('/wda/simulatedLocation', 'POST', { latitude, longitude });
 }
 /**
  * Resets simulated geolocation value.
@@ -44,15 +32,10 @@ async function mobileSetSimulatedLocation(latitude, longitude) {
  * ! Do not forget to reset the simulated geolocation value after your automated test is finished.
  * ! If the value is not reset explicitly then the simulated one will remain until the next device restart.
  *
- * @returns {Promise<void>}
- * @throws {Error} If the device under test does not support gelolocation simulation.
+ * @throws If the device under test does not support geolocation simulation.
  * @since 4.18
- * @this {XCUITestDriver}
  */
 async function mobileResetSimulatedLocation() {
-    return await this.proxyCommand('/wda/simulatedLocation', 'DELETE');
+    await this.proxyCommand('/wda/simulatedLocation', 'DELETE');
 }
-/**
- * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
- */
 //# sourceMappingURL=geolocation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../../lib/commands/geolocation.js"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAWH,gEAEC;AAaD,gEAEC;AAaD,oEAEC;AAzCD;;;;;;;;GAQG;AACI,KAAK,UAAU,0BAA0B;IAC9C,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,0BAA0B,CAAC,QAAQ,EAAE,SAAS;IAClE,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,QAAQ,EAAE,SAAS,EAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,4BAA4B;IAChD,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG"}
+{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../../lib/commands/geolocation.ts"],"names":[],"mappings":";;AAiBA,gEAIC;AAWD,gEAMC;AAWD,oEAIC;AA5CD;;;;;;;GAOG;AACI,KAAK,UAAU,0BAA0B;IAG9C,OAAO,MAAM,IAAI,CAAC,YAAY,CAAuB,wBAAwB,EAAE,KAAK,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,0BAA0B,CAE9C,QAAgB,EAChB,SAAiB;IAEjB,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,QAAQ,EAAE,SAAS,EAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,4BAA4B;IAGhD,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC"}