appium-uiautomator2-driver 6.7.5 → 6.7.6

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [6.7.6](https://github.com/appium/appium-uiautomator2-driver/compare/v6.7.5...v6.7.6) (2025-12-23)
+
+### Miscellaneous Chores
+
+* Migrate various command modules to typescript (part 2) ([#970](https://github.com/appium/appium-uiautomator2-driver/issues/970)) ([976d79d](https://github.com/appium/appium-uiautomator2-driver/commit/976d79dcb122f5ba28128d16c7b90a5d37dc868f))
+
 ## [6.7.5](https://github.com/appium/appium-uiautomator2-driver/compare/v6.7.4...v6.7.5) (2025-12-22)
 
 ### Miscellaneous Chores

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

@@ -1,102 +1,68 @@
+import type { DoSetElementValueOpts } from 'appium-android-driver';
+import type { Element as AppiumElement, Position, Rect, Size } from '@appium/types';
+import type { AndroidUiautomator2Driver } from '../driver';
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<import('@appium/types').Element>}
+ * Gets the currently active element.
  */
-export function active(this: import("../driver").AndroidUiautomator2Driver): Promise<import("@appium/types").Element>;
+export declare function active(this: AndroidUiautomator2Driver): Promise<AppiumElement>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} attribute
- * @param {string} elementId
- * @returns {Promise<string?>}
+ * Gets an element attribute value.
  */
-export function getAttribute(this: import("../driver").AndroidUiautomator2Driver, attribute: string, elementId: string): Promise<string | null>;
+export declare function getAttribute(this: AndroidUiautomator2Driver, attribute: string, elementId: string): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is displayed.
  */
-export function elementDisplayed(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
+export declare function elementDisplayed(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is enabled.
  */
-export function elementEnabled(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
+export declare function elementEnabled(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is selected.
  */
-export function elementSelected(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
+export declare function elementSelected(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<string>}
+ * Gets the element tag name.
  */
-export function getName(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<string>;
+export declare function getName(this: AndroidUiautomator2Driver, elementId: string): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Position>}
+ * Gets the element location.
  */
-export function getLocation(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<import("@appium/types").Position>;
+export declare function getLocation(this: AndroidUiautomator2Driver, elementId: string): Promise<Position>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Size>}
+ * Gets the element size.
  */
-export function getSize(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<import("@appium/types").Size>;
+export declare function getSize(this: AndroidUiautomator2Driver, elementId: string): Promise<Size>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {import('appium-android-driver').DoSetElementValueOpts} params
- * @returns {Promise<void>}
+ * Sets the value of an element using the upstream driver API.
  */
-export function doSetElementValue(this: import("../driver").AndroidUiautomator2Driver, params: import("appium-android-driver").DoSetElementValueOpts): Promise<void>;
+export declare function doSetElementValue(this: AndroidUiautomator2Driver, params: DoSetElementValueOpts): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string|string[]} keys
- * @param {string} elementId
- * @returns {Promise<void>}
+ * Sends text to an element without replacement.
  */
-export function setValueImmediate(this: import("../driver").AndroidUiautomator2Driver, keys: string | string[], elementId: string): Promise<void>;
+export declare function setValueImmediate(this: AndroidUiautomator2Driver, keys: string | string[], elementId: string): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<string>}
+ * Gets the element text.
  */
-export function getText(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<string>;
+export declare function getText(this: AndroidUiautomator2Driver, elementId: string): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} element
- * @returns {Promise<void>}
+ * Clicks the given element.
  */
-export function click(this: import("../driver").AndroidUiautomator2Driver, element: string): Promise<void>;
+export declare function click(this: AndroidUiautomator2Driver, element: string): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} element
- * @returns {Promise<string>}
+ * Takes a screenshot of the element.
  */
-export function getElementScreenshot(this: import("../driver").AndroidUiautomator2Driver, element: string): Promise<string>;
+export declare function getElementScreenshot(this: AndroidUiautomator2Driver, element: string): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<void>}
+ * Clears the element text.
  */
-export function clear(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<void>;
+export declare function clear(this: AndroidUiautomator2Driver, elementId: string): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Rect>}
+ * Gets the element rectangle.
  */
-export function getElementRect(this: import("../driver").AndroidUiautomator2Driver, elementId: string): Promise<import("@appium/types").Rect>;
+export declare function getElementRect(this: AndroidUiautomator2Driver, elementId: string): Promise<Rect>;
 /**
- * Sends text to the given element by replacing its previous content
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId The id of the element whose content will be replaced.
- * @param {string} text The actual text to set.
- * @throws {Error} If there was a faulre while setting the text
- * @returns {Promise<void>}
+ * Replaces the element text.
  */
-export function mobileReplaceElementValue(this: import("../driver").AndroidUiautomator2Driver, elementId: string, text: string): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function mobileReplaceElementValue(this: AndroidUiautomator2Driver, elementId: string, text: string): Promise<void>;
 //# sourceMappingURL=element.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../lib/commands/element.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,6EAFa,OAAO,CAAC,OAAO,eAAe,EAAE,OAAO,CAAC,CASpD;AAED;;;;;GAKG;AACH,6FAJW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;AAED;;;;GAIG;AACH,iGAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAI5B;AAED;;;;GAIG;AACH,+FAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAI5B;AAED;;;;GAIG;AACH,gGAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAI5B;AAED;;;;GAIG;AACH,wFAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAU3B;AAED;;;;GAIG;AACH,4FAHW,MAAM,GACJ,OAAO,CAAC,OAAO,eAAe,EAAE,QAAQ,CAAC,CAUrD;AAED;;;;GAIG;AACH,wFAHW,MAAM,GACJ,OAAO,CAAC,OAAO,eAAe,EAAE,IAAI,CAAC,CAUjD;AAED;;;;GAIG;AACH,+FAHW,OAAO,uBAAuB,EAAE,qBAAqB,GACnD,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;;;GAKG;AACH,6FAJW,MAAM,GAAC,MAAM,EAAE,aACf,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAYzB;AAED;;;;GAIG;AACH,wFAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAU3B;AAED;;;;GAIG;AACH,oFAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;;GAIG;AACH,mGAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAU3B;AAED;;;;GAIG;AACH,sFAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAUzB;AAED;;;;GAIG;AACH,+FAHW,MAAM,GACJ,OAAO,CAAC,OAAO,eAAe,EAAE,IAAI,CAAC,CA4BjD;AAED;;;;;;;GAOG;AACH,0GALW,MAAM,QACN,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CAWzB;wCAeY,OAAO,WAAW,EAAE,yBAAyB"}
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../lib/commands/element.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAC,OAAO,IAAI,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAC,MAAM,eAAe,CAAC;AAClF,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AAGzD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzH;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzG;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1G;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEvG;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAErH;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5G;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActG;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/build/lib/commands/element.js

@@ -19,86 +19,65 @@ exports.getElementScreenshot = getElementScreenshot;
 exports.clear = clear;
 exports.getElementRect = getElementRect;
 exports.mobileReplaceElementValue = mobileReplaceElementValue;
+const driver_1 = require("appium/driver");
 const bluebird_1 = __importDefault(require("bluebird"));
 const lodash_1 = __importDefault(require("lodash"));
-const driver_1 = require("appium/driver");
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<import('@appium/types').Element>}
+ * Gets the currently active element.
  */
 async function active() {
-    return /** @type {import('@appium/types').Element} */ (await this.uiautomator2.jwproxy.command('/element/active', 'GET'));
+    return (await this.uiautomator2.jwproxy.command('/element/active', 'GET'));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} attribute
- * @param {string} elementId
- * @returns {Promise<string?>}
+ * Gets an element attribute value.
  */
 async function getAttribute(attribute, elementId) {
     return String(await this.uiautomator2.jwproxy.command(`/element/${elementId}/attribute/${attribute}`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is displayed.
  */
 async function elementDisplayed(elementId) {
     return toBool(await this.getAttribute('displayed', elementId));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is enabled.
  */
 async function elementEnabled(elementId) {
     return toBool(await this.getAttribute('enabled', elementId));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<boolean>}
+ * Returns whether the element is selected.
  */
 async function elementSelected(elementId) {
     return toBool(await this.getAttribute('selected', elementId));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<string>}
+ * Gets the element tag name.
  */
 async function getName(elementId) {
-    return /** @type {string} */ (await this.uiautomator2.jwproxy.command(`/element/${elementId}/name`, 'GET', {}));
+    return (await this.uiautomator2.jwproxy.command(`/element/${elementId}/name`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Position>}
+ * Gets the element location.
  */
 async function getLocation(elementId) {
-    return /** @type {import('@appium/types').Position} */ (await this.uiautomator2.jwproxy.command(`/element/${elementId}/location`, 'GET', {}));
+    return (await this.uiautomator2.jwproxy.command(`/element/${elementId}/location`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Size>}
+ * Gets the element size.
  */
 async function getSize(elementId) {
-    return /** @type {import('@appium/types').Size} */ (await this.uiautomator2.jwproxy.command(`/element/${elementId}/size`, 'GET', {}));
+    return (await this.uiautomator2.jwproxy.command(`/element/${elementId}/size`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {import('appium-android-driver').DoSetElementValueOpts} params
- * @returns {Promise<void>}
+ * Sets the value of an element using the upstream driver API.
  */
 async function doSetElementValue(params) {
     await this.uiautomator2.jwproxy.command(`/element/${params.elementId}/value`, 'POST', params);
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string|string[]} keys
- * @param {string} elementId
- * @returns {Promise<void>}
+ * Sends text to an element without replacement.
  */
 async function setValueImmediate(keys, elementId) {
     await this.uiautomator2.jwproxy.command(`/element/${elementId}/value`, 'POST', {
@@ -108,67 +87,48 @@ async function setValueImmediate(keys, elementId) {
     });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<string>}
+ * Gets the element text.
  */
 async function getText(elementId) {
     return String(await this.uiautomator2.jwproxy.command(`/element/${elementId}/text`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} element
- * @returns {Promise<void>}
+ * Clicks the given element.
  */
 async function click(element) {
     await this.uiautomator2.jwproxy.command(`/element/${element}/click`, 'POST', { element });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} element
- * @returns {Promise<string>}
+ * Takes a screenshot of the element.
  */
 async function getElementScreenshot(element) {
     return String(await this.uiautomator2.jwproxy.command(`/element/${element}/screenshot`, 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<void>}
+ * Clears the element text.
  */
 async function clear(elementId) {
-    await this.uiautomator2.jwproxy.command(`/element/${elementId}/clear`, 'POST', {
-        elementId,
-    });
+    await this.uiautomator2.jwproxy.command(`/element/${elementId}/clear`, 'POST', { elementId });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId
- * @returns {Promise<import('@appium/types').Rect>}
+ * Gets the element rectangle.
  */
 async function getElementRect(elementId) {
-    const chromedriver = /** @type {import('appium-chromedriver').default} */ (this.chromedriver);
-    if (this.isWebContext()) {
-        this.log.debug(`Detected downstream chromedriver protocol: ${chromedriver.jwproxy.downstreamProtocol}`);
-        if (chromedriver.jwproxy.downstreamProtocol === driver_1.PROTOCOLS.MJSONWP) {
-            const [{ x, y }, { width, height }] = 
-            /** @type {[import('@appium/types').Position, import('@appium/types').Size]} */ (await bluebird_1.default.all([
-                chromedriver.jwproxy.command(`/element/${elementId}/location`, 'GET'),
-                chromedriver.jwproxy.command(`/element/${elementId}/size`, 'GET'),
-            ]));
-            return { x, y, width, height };
-        }
-        return /** @type {import('@appium/types').Rect} */ (await chromedriver.jwproxy.command(`/element/${elementId}/rect`, 'GET'));
+    if (!this.isWebContext()) {
+        return (await this.uiautomator2.jwproxy.command(`/element/${elementId}/rect`, 'GET'));
+    }
+    const chromedriver = this.chromedriver;
+    if (chromedriver.jwproxy.downstreamProtocol === driver_1.PROTOCOLS.MJSONWP) {
+        const [{ x, y }, { width, height }] = (await bluebird_1.default.all([
+            chromedriver.jwproxy.command(`/element/${elementId}/location`, 'GET'),
+            chromedriver.jwproxy.command(`/element/${elementId}/size`, 'GET'),
+        ]));
+        return { x, y, width, height };
     }
-    return /** @type {import('@appium/types').Rect} */ (await this.uiautomator2.jwproxy.command(`/element/${elementId}/rect`, 'GET'));
+    return (await chromedriver.jwproxy.command(`/element/${elementId}/rect`, 'GET'));
 }
 /**
- * Sends text to the given element by replacing its previous content
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId The id of the element whose content will be replaced.
- * @param {string} text The actual text to set.
- * @throws {Error} If there was a faulre while setting the text
- * @returns {Promise<void>}
+ * Replaces the element text.
  */
 async function mobileReplaceElementValue(elementId, text) {
     await this.uiautomator2.jwproxy.command(`/element/${elementId}/value`, 'POST', {
@@ -176,16 +136,7 @@ async function mobileReplaceElementValue(elementId, text) {
         replace: true,
     });
 }
-// #region Internal Helpers
-/**
- * @param {any} s
- * @returns {boolean}
- */
-function toBool(s) {
-    return lodash_1.default.isString(s) ? s.toLowerCase() === 'true' : !!s;
+function toBool(value) {
+    return lodash_1.default.isString(value) ? value.toLowerCase() === 'true' : !!value;
 }
-// #endregion
-/**
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
 //# sourceMappingURL=element.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"element.js","sourceRoot":"","sources":["../../../lib/commands/element.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../../../lib/commands/element.ts"],"names":[],"mappings":";;;;;AAWA,wBAEC;AAKD,oCAEC;AAKD,4CAEC;AAKD,wCAEC;AAKD,0CAEC;AAKD,0BAEC;AAKD,kCAEC;AAKD,0BAEC;AAKD,8CAEC;AAKD,8CAUC;AAKD,0BAEC;AAKD,sBAEC;AAKD,oDAEC;AAKD,sBAEC;AAKD,wCAcC;AAKD,8DASC;AAjJD,0CAAwC;AACxC,wDAAyB;AACzB,oDAAuB;AAMvB;;GAEG;AACI,KAAK,UAAU,MAAM;IAC1B,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAkB,CAAC;AAC9F,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,YAAY,CAAkC,SAAiB,EAAE,SAAiB;IACtG,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,cAAc,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AACpH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAkC,SAAiB;IACvF,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAAkC,SAAiB;IACrF,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CAAkC,SAAiB;IACtF,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,OAAO,CAAkC,SAAiB;IAC9E,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAW,CAAC;AACtG,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAkC,SAAiB;IAClF,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAa,CAAC;AAC5G,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,OAAO,CAAkC,SAAiB;IAC9E,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAS,CAAC;AACpG,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAkC,MAA6B;IACpG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAChG,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAErC,IAAuB,EACvB,SAAiB;IAEjB,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,QAAQ,EAAE,MAAM,EAAE;QAC7E,SAAS;QACT,IAAI,EAAE,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QAC5C,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,OAAO,CAAkC,SAAiB;IAC9E,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAClG,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,KAAK,CAAkC,OAAe;IAC1E,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,OAAO,QAAQ,EAAE,MAAM,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAkC,OAAe;IACzF,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,OAAO,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AACtG,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,KAAK,CAAkC,SAAiB;IAC5E,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,QAAQ,EAAE,MAAM,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAAkC,SAAiB;IACrF,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,CAAC,CAAS,CAAC;IAChG,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAA4B,CAAC;IACvD,IAAI,YAAY,CAAC,OAAO,CAAC,kBAAkB,KAAK,kBAAS,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,EAAC,KAAK,EAAE,MAAM,EAAC,CAAC,GAAG,CAAC,MAAM,kBAAC,CAAC,GAAG,CAAC;YAC7C,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,WAAW,EAAE,KAAK,CAAC;YACrE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,CAAC;SAClE,CAAC,CAAqB,CAAC;QACxB,OAAO,EAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,OAAO,EAAE,KAAK,CAAC,CAAS,CAAC;AAC3F,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,yBAAyB,CAE7C,SAAiB,EACjB,IAAY;IAEZ,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,SAAS,QAAQ,EAAE,MAAM,EAAE;QAC7E,IAAI;QACJ,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CAAC,KAAU;IACxB,OAAO,gBAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC"}

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

@@ -1,212 +1,47 @@
+import type { Element as AppiumElement } from '@appium/types';
+import type { AndroidUiautomator2Driver } from '../driver';
 /**
- * Performs a simple click/tap gesture
- *
- * @this {AndroidUiautomator2Driver}
- * @param {string} [elementId] The id of the element to be clicked.
- * If the element is missing then both click offset coordinates must be provided.
- * If both the element id and offset are provided then the coordinates are parsed
- * as relative offsets from the top left corner of the element.
- * @param {number} [x] The x coordinate to click on.
- * @param {number} [y] The y coordinate to click on.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a simple click/tap gesture.
  */
-export function mobileClickGesture(this: import("../driver").AndroidUiautomator2Driver, elementId?: string, x?: number, y?: number): Promise<void>;
+export declare function mobileClickGesture(this: AndroidUiautomator2Driver, elementId?: AppiumElement | string, x?: number, y?: number): Promise<void>;
 /**
- * Performs a click that lasts for the given duration
- *
- * @this {AndroidUiautomator2Driver}
- * @param {string} [elementId] The id of the element to be clicked.
- * If the element is missing then both click offset coordinates must be provided.
- * If both the element id and offset are provided then the coordinates are parsed
- * as relative offsets from the top left corner of the element.
- * @param {number} [x] The x coordinate to click on.
- * @param {number} [y] The y coordinate to click on.
- * @param {number} [duration] Click duration in milliseconds. The value must not be negative.
- * Default is 500.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a long click with an optional duration.
  */
-export function mobileLongClickGesture(this: import("../driver").AndroidUiautomator2Driver, elementId?: string, x?: number, y?: number, duration?: number): Promise<void>;
+export declare function mobileLongClickGesture(this: AndroidUiautomator2Driver, elementId?: AppiumElement | string, x?: number, y?: number, duration?: number): Promise<void>;
 /**
- * Performs a click that lasts for the given duration
- * @this {AndroidUiautomator2Driver}
- * @param {string} [elementId] The id of the element to be clicked.
- * If the element is missing then both click offset coordinates must be provided.
- * If both the element id and offset are provided then the coordinates are parsed
- * as relative offsets from the top left corner of the element.
- * @param {number} [x] The x coordinate to click on.
- * @param {number} [y] The y coordinate to click on.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a double-click gesture.
  */
-export function mobileDoubleClickGesture(this: import("../driver").AndroidUiautomator2Driver, elementId?: string, x?: number, y?: number): Promise<void>;
+export declare function mobileDoubleClickGesture(this: AndroidUiautomator2Driver, elementId?: AppiumElement | string, x?: number, y?: number): Promise<void>;
 /**
- * Drags this object to the specified location.
- * @this {AndroidUiautomator2Driver}
- * @param {string} [elementId] The id of the element to be dragged.
- * If the element id is missing then the start coordinates must be provided.
- * If both the element id and the start coordinates are provided then these
- * coordinates are considered as offsets from the top left element corner.
- * @param {number} [startX] The x coordinate where the dragging starts
- * @param {number} [startY] The y coordinate where the dragging starts
- * @param {number} [endX] The x coordinate where the dragging ends
- * @param {number} [endY] The y coordinate where the dragging ends
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must not be negative.
- * Default is 2500 * displayDensity.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Drags from a start point to an end point.
  */
-export function mobileDragGesture(this: import("../driver").AndroidUiautomator2Driver, elementId?: string, startX?: number, startY?: number, endX?: number, endY?: number, speed?: number): Promise<void>;
+export declare function mobileDragGesture(this: AndroidUiautomator2Driver, elementId?: AppiumElement | string, startX?: number, startY?: number, endX?: number, endY?: number, speed?: number): Promise<void>;
 /**
- * Drags to the specified location.
- *
- * @throws {Error} if provided options are not valid
- * @this {AndroidUiautomator2Driver}
- * @param {string} direction Direction of the fling.
- * Acceptable values are: `up`, `down`, `left` and `right` (case insensitive).
- * @param {string} [elementId] The id of the element to be flinged.
- * If the element id is missing then fling bounding area must be provided.
- * If both the element id and the fling bounding area are provided then this
- * area is effectively ignored.
- * @param {number} [left] The left coordinate of the fling bounding area.
- * @param {number} [top] The top coordinate of the fling bounding area.
- * @param {number} [width] The width of the fling bounding area.
- * @param {number} [height] The height of the fling bounding area.
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must be greater than the minimum fling velocity for the given view (50 by default).
- * Default is 7500 * displayDensity.
- * @returns {Promise<boolean>} True if the object can still scroll in the given direction.
+ * Performs a fling gesture and reports if further scrolling is possible.
  */
-export function mobileFlingGesture(this: import("../driver").AndroidUiautomator2Driver, direction: string, elementId?: string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<boolean>;
+export declare function mobileFlingGesture(this: AndroidUiautomator2Driver, direction: string, elementId?: AppiumElement | string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<boolean>;
 /**
- * Performs a pinch close gesture.
- * @this {AndroidUiautomator2Driver}
- * @param {number} percent The size of the pinch as a percentage of the pinch area size.
- * Valid values must be float numbers in range 0..1, where 1.0 is 100%
- * @param {string} [elementId] The id of the element to be pinched.
- * If the element id is missing then pinch bounding area must be provided.
- * If both the element id and the pinch bounding area are provided then the
- * area is effectively ignored.
- * @param {number} [left] The left coordinate of the pinch bounding area.
- * @param {number} [top] The top coordinate of the pinch bounding area.
- * @param {number} [width] The width of the pinch bounding area.
- * @param {number} [height] The height of the pinch bounding area.
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must not be negative.
- * Default is 2500 * displayDensity.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a pinch-close gesture.
  */
-export function mobilePinchCloseGesture(this: import("../driver").AndroidUiautomator2Driver, percent: number, elementId?: string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
+export declare function mobilePinchCloseGesture(this: AndroidUiautomator2Driver, percent: number, elementId?: AppiumElement | string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
 /**
- * Performs a pinch open gesture.
- * @this {AndroidUiautomator2Driver}
- * @param {number} percent The size of the pinch as a percentage of the pinch area size.
- * Valid values must be float numbers in range 0..1, where 1.0 is 100%
- * @param {string} [elementId] The id of the element to be pinched.
- * If the element id is missing then pinch bounding area must be provided.
- * If both the element id and the pinch bounding area are provided then the
- * area is effectively ignored.
- * @param {number} [left] The left coordinate of the pinch bounding area.
- * @param {number} [top] The top coordinate of the pinch bounding area.
- * @param {number} [width] The width of the pinch bounding area.
- * @param {number} [height] The height of the pinch bounding area.
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must not be negative.
- * Default is 2500 * displayDensity.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a pinch-open gesture.
  */
-export function mobilePinchOpenGesture(this: import("../driver").AndroidUiautomator2Driver, percent: number, elementId?: string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
+export declare function mobilePinchOpenGesture(this: AndroidUiautomator2Driver, percent: number, elementId?: AppiumElement | string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
 /**
- * Performs a swipe gesture.
- * @this {AndroidUiautomator2Driver}
- * @param {string} direction Direction of the swipe.
- * Acceptable values are: `up`, `down`, `left` and `right` (case insensitive).
- * @param {number} percent The size of the swipe as a percentage of the swipe area size.
- * Valid values must be float numbers in range 0..1, where 1.0 is 100%.
- * @param {string} [elementId] The id of the element to be swiped.
- * If the element id is missing then swipe bounding area must be provided.
- * If both the element id and the swipe bounding area are provided then the
- * area is effectively ignored.
- * @param {number} [left] The left coordinate of the swipe bounding area.
- * @param {number} [top] The top coordinate of the swipe bounding area.
- * @param {number} [width] The width of the swipe bounding area.
- * @param {number} [height] The height of the swipe bounding area.
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must not be negative.
- * Default is 5000 * displayDensity.
- * @returns {Promise<void>}
- * @throws {Error} if provided options are not valid
+ * Performs a swipe gesture for the given direction and percent.
  */
-export function mobileSwipeGesture(this: import("../driver").AndroidUiautomator2Driver, direction: string, percent: number, elementId?: string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
+export declare function mobileSwipeGesture(this: AndroidUiautomator2Driver, direction: string, percent: number, elementId?: AppiumElement | string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<void>;
 /**
- * Performs a scroll gesture.
- *
- * @throws {Error} if provided options are not valid
- * @this {AndroidUiautomator2Driver}
- * @param {string} direction Direction of the scroll.
- * Acceptable values are: `up`, `down`, `left` and `right` (case insensitive).
- * @param {number} percent The size of the scroll as a percentage of the scrolling area size.
- * Valid values must be float numbers greater than zero, where 1.0 is 100%.
- * @param {string} [elementId] The id of the element to be scrolled.
- * If the element id is missing then scroll bounding area must be provided.
- * If both the element id and the scroll bounding area are provided then this
- * area is effectively ignored.
- * @param {number} [left] The left coordinate of the scroll bounding area.
- * @param {number} [top] The top coordinate of the scroll bounding area.
- * @param {number} [width] The width of the scroll bounding area.
- * @param {number} [height] The height of the scroll bounding area.
- * @param {number} [speed] The speed at which to perform this gesture in pixels per second.
- * The value must not be negative.
- * Default is 5000 * displayDensity.
- * @returns {Promise<boolean>} True if the object can still scroll in the given direction.
+ * Performs a scroll gesture and reports if further scrolling is possible.
  */
-export function mobileScrollGesture(this: import("../driver").AndroidUiautomator2Driver, direction: string, percent: number, elementId?: string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<boolean>;
+export declare function mobileScrollGesture(this: AndroidUiautomator2Driver, direction: string, percent: number, elementId?: AppiumElement | string, left?: number, top?: number, width?: number, height?: number, speed?: number): Promise<boolean>;
 /**
- * Scrolls the given scrollable element `elementId` until `elementToId`
- * becomes visible. This function returns immediately if the `elementToId`
- * is already visible in the view port. Otherwise it would scroll
- * to the very beginning of the scrollable control and tries to reach the destination element
- * by scrolling its parent to the end step by step. The scroll direction (vertical or horizontal)
- * is detected automatically.
- * @this {AndroidUiautomator2Driver}
- * @param {string} elementId The identifier of the scrollable element, which is going to be scrolled.
- * It is required this element is a valid scrollable container and it was located
- * by `-android uiautomator` strategy.
- * @param {string} elementToId The identifier of the item, which belongs to the scrollable element above,
- * and which should become visible after the scrolling operation is finished.
- * It is required this element was located by `-android uiautomator` strategy.
- * @returns {Promise<void>}
- * @throws {Error} if the scrolling operation cannot be performed
+ * Scrolls a scrollable element until a target element becomes visible.
  */
-export function mobileScrollBackTo(this: import("../driver").AndroidUiautomator2Driver, elementId: string, elementToId: string): Promise<void>;
+export declare function mobileScrollBackTo(this: AndroidUiautomator2Driver, elementId?: string, elementToId?: string): Promise<void>;
 /**
- * Scrolls the given scrollable element until the element identified
- * by `strategy` and `selector` becomes visible. This function returns immediately if the
- * destination element is already visible in the view port. Otherwise it would scroll
- * to the very beginning of the scrollable control and tries to reach the destination element
- * by scrolling its parent to the end step by step. The scroll direction (vertical or horizontal)
- * is detected automatically.
- *
- * @this {AndroidUiautomator2Driver}
- * @param {string} strategy The following strategies are supported:
- * - `accessibility id` (UiSelector().description)
- * - `class name` (UiSelector().className)
- * - `-android uiautomator` (UiSelector)
- * @param {string} selector The corresponding lookup value for the given strategy.
- * @param {string} [elementId] The identifier of an element. It is required this element is a valid scrollable container
- * and it was located by `-android uiautomator` strategy.
- * If this property is not provided then the first currently available scrollable view
- * is selected for the interaction.
- * @param {number} [maxSwipes] The maximum number of swipes to perform on the target scrollable view in order to reach
- * the destination element. In case this value is unset then it would be retrieved from the
- * scrollable element itself (via `getMaxSearchSwipes()` property).
- * @returns {Promise<void>}
- * @throws {Error} if the scrolling operation cannot be performed
+ * Scrolls until an element located by the given strategy is visible.
  */
-export function mobileScroll(this: import("../driver").AndroidUiautomator2Driver, strategy: string, selector: string, elementId?: string, maxSwipes?: number): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function mobileScroll(this: AndroidUiautomator2Driver, strategy: string, selector: string, elementId?: AppiumElement | string, maxSwipes?: number): Promise<void>;
 //# sourceMappingURL=gestures.d.ts.map