webdriverio 7.20.7 → 7.20.8-alpha.504

package/build/utils/actions/base.d.ts

@@ -0,0 +1,32 @@
+export declare type ActionType = 'key' | 'pointer' | 'wheel';
+export declare type KeyActionType = 'mouse' | 'pen' | 'touch';
+export interface ActionParameters {
+    pointerType?: KeyActionType;
+}
+export interface BaseActionParams {
+    id?: string;
+    parameters?: ActionParameters;
+}
+export default class BaseAction {
+    #private;
+    protected instance: WebdriverIO.Browser;
+    protected sequence: any[];
+    constructor(instance: WebdriverIO.Browser, type: ActionType, params?: BaseActionParams);
+    toJSON(): {
+        id: string;
+        type: ActionType;
+        parameters: ActionParameters;
+        actions: any[];
+    };
+    /**
+     * Inserts a pause action for the specified device, ensuring it idles for a tick.
+     * @param duration idle time of tick
+     */
+    pause(duration: number): this;
+    /**
+     * Perform action sequence
+     * @param skipRelease set to true if `releaseActions` command should not be invoked
+     */
+    perform(skipRelease?: boolean): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/build/utils/actions/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/utils/actions/base.ts"],"names":[],"mappings":"AAEA,oBAAY,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAA;AACpD,oBAAY,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;AACrD,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,aAAa,CAAA;CAC9B;AACD,MAAM,WAAW,gBAAgB;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAChC;AAID,MAAM,CAAC,OAAO,OAAO,UAAU;;IAQvB,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO;IAH3C,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAK;gBAGhB,QAAQ,EAAE,WAAW,CAAC,OAAO,EACvC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,gBAAgB;IAQ7B,MAAM;;;;;;IASN;;;OAGG;IACH,KAAK,CAAE,QAAQ,EAAE,MAAM;IAKvB;;;OAGG;IACG,OAAO,CAAE,WAAW,UAAQ;CAiCrC"}

package/build/utils/actions/base.js

@@ -0,0 +1,66 @@
+import { ELEMENT_KEY } from '../../constants.js';
+let actionIds = 0;
+export default class BaseAction {
+    instance;
+    #id;
+    #type;
+    #parameters;
+    #instance;
+    sequence = [];
+    constructor(instance, type, params) {
+        this.instance = instance;
+        this.#instance = instance;
+        this.#id = params?.id || `action${++actionIds}`;
+        this.#type = type;
+        this.#parameters = params?.parameters || {};
+    }
+    toJSON() {
+        return {
+            id: this.#id,
+            type: this.#type,
+            parameters: this.#parameters,
+            actions: this.sequence
+        };
+    }
+    /**
+     * Inserts a pause action for the specified device, ensuring it idles for a tick.
+     * @param duration idle time of tick
+     */
+    pause(duration) {
+        this.sequence.push({ type: 'pause', duration });
+        return this;
+    }
+    /**
+     * Perform action sequence
+     * @param skipRelease set to true if `releaseActions` command should not be invoked
+     */
+    async perform(skipRelease = false) {
+        /**
+         * transform chainable / not resolved elements into WDIO elements
+         */
+        for (const seq of this.sequence) {
+            /**
+             * continue if we don't deal with origin or elements within
+             * origin at all
+             */
+            if (!seq.origin || typeof seq.origin === 'string') {
+                continue;
+            }
+            /**
+             * resolve promise element
+             */
+            if (typeof seq.origin.then === 'function') {
+                await seq.origin.waitForExist();
+                seq.origin = await seq.origin;
+            }
+            if (!seq.origin[ELEMENT_KEY]) {
+                throw new Error(`Couldn't find element for "${seq.type}" action sequence`);
+            }
+            seq.origin = { [ELEMENT_KEY]: seq.origin[ELEMENT_KEY] };
+        }
+        await this.#instance.performActions([this.toJSON()]);
+        if (!skipRelease) {
+            await this.#instance.releaseActions();
+        }
+    }
+}

package/build/utils/actions/index.d.ts

@@ -0,0 +1,6 @@
+export { default as KeyAction } from './key.js';
+export { default as PointerAction } from './pointer.js';
+export { default as WheelAction } from './wheel.js';
+export * from './base.js';
+export * from './pointer.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAA;AACnD,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/build/utils/actions/index.js

@@ -0,0 +1,5 @@
+export { default as KeyAction } from './key.js';
+export { default as PointerAction } from './pointer.js';
+export { default as WheelAction } from './wheel.js';
+export * from './base.js';
+export * from './pointer.js';

package/build/utils/actions/key.d.ts

@@ -0,0 +1,15 @@
+import BaseAction, { BaseActionParams } from './base.js';
+export default class KeyAction extends BaseAction {
+    constructor(instance: WebdriverIO.Browser, params?: BaseActionParams);
+    /**
+     * Generates a key up action.
+     * @param value key value
+     */
+    up(value: string): this;
+    /**
+     * Generates a key down action.
+     * @param value key value
+     */
+    down(value: string): this;
+}
+//# sourceMappingURL=key.d.ts.map

package/build/utils/actions/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../../src/utils/actions/key.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAExD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,UAAU;gBAChC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAIrE;;;OAGG;IACH,EAAE,CAAE,KAAK,EAAE,MAAM;IAKjB;;;OAGG;IACH,IAAI,CAAE,KAAK,EAAE,MAAM;CAItB"}

package/build/utils/actions/key.js

@@ -0,0 +1,22 @@
+import BaseAction from './base.js';
+export default class KeyAction extends BaseAction {
+    constructor(instance, params) {
+        super(instance, 'key', params);
+    }
+    /**
+     * Generates a key up action.
+     * @param value key value
+     */
+    up(value) {
+        this.sequence.push({ type: 'keyUp', value });
+        return this;
+    }
+    /**
+     * Generates a key down action.
+     * @param value key value
+     */
+    down(value) {
+        this.sequence.push({ type: 'keyDown', value });
+        return this;
+    }
+}

package/build/utils/actions/pointer.d.ts

@@ -0,0 +1,62 @@
+import { ElementReference } from '@wdio/protocols';
+import BaseAction, { BaseActionParams } from './base.js';
+import type { ChainablePromiseElement } from '../../types';
+export declare type ButtonNames = 'left' | 'middle' | 'right';
+export declare type Button = 0 | 1 | 2;
+export declare type Origin = 'pointer' | 'viewport';
+interface PointerActionUpParams {
+    /**
+     * The button to press (e.g. 0 for left, 1 for middle or 2 for right)
+     * @default 0
+     */
+    button: Button;
+}
+declare const PARAM_DEFAULTS: {
+    width: number;
+    height: number;
+    pressure: number;
+    tangentialPressure: number;
+    tiltX: number;
+    tiltY: number;
+    twist: number;
+    altitudeAngle: number;
+    azimuthAngle: number;
+    button: Button;
+};
+declare const MOVE_PARAM_DEFAULTS: {
+    x: number;
+    y: number;
+    duration: number;
+    origin: ElementReference | ChainablePromiseElement<WebdriverIO.Element> | Origin;
+};
+declare type PointerActionParams = Partial<typeof PARAM_DEFAULTS> & Partial<PointerActionUpParams>;
+declare type PointerActionMoveParams = Partial<typeof MOVE_PARAM_DEFAULTS> & PointerActionParams;
+export default class PointerAction extends BaseAction {
+    constructor(instance: WebdriverIO.Browser, params?: BaseActionParams);
+    /**
+     * Creates an action for moving the pointer `x` and `y` pixels from the specified
+     * `origin`. The `origin` may be defined as the pointers current position (e.g. "pointer"),
+     * the viewport (e.g. "viewport") or the center of a specific element.
+     * @param params PointerActionMoveParams
+     */
+    move(params: PointerActionMoveParams): PointerAction;
+    move(x: number, y: number): PointerAction;
+    /**
+     * Creates an action to release a single key.
+     * @param params PointerActionUpParams
+     */
+    up(button?: ButtonNames): PointerAction;
+    up(params?: PointerActionUpParams): PointerAction;
+    /**
+     * Creates an action to press a single key
+     * @param params PointerActionParams
+     */
+    down(button?: ButtonNames): PointerAction;
+    down(params?: PointerActionParams): PointerAction;
+    /**
+     * An action that cancels this pointer's current input.
+     */
+    cancel(): this;
+}
+export {};
+//# sourceMappingURL=pointer.d.ts.map

package/build/utils/actions/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../src/utils/actions/pointer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,UAAU,EAAE,EAAE,gBAAgB,EAAiB,MAAM,WAAW,CAAA;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,oBAAY,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AACrD,oBAAY,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC9B,oBAAY,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAM3C,UAAU,qBAAqB;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACjB;AAKD,QAAA,MAAM,cAAc;;;;;;;;;;;CAWnB,CAAA;AACD,QAAA,MAAM,mBAAmB;;;;;CAKxB,CAAA;AAED,aAAK,mBAAmB,GAAG,OAAO,CAAC,OAAO,cAAc,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAC1F,aAAK,uBAAuB,GAAG,OAAO,CAAC,OAAO,mBAAmB,CAAC,GAAG,mBAAmB,CAAA;AAExF,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAU;gBACpC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAE,gBAAqB;IAQzE;;;;;OAKG;IACH,IAAI,CAAE,MAAM,EAAE,uBAAuB,GAAG,aAAa;IACrD,IAAI,CAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa;IAoB1C;;;OAGG;IACH,EAAE,CAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa;IACxC,EAAE,CAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,aAAa;IAWlD;;;OAGG;IACH,IAAI,CAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa;IAC1C,IAAI,CAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa;IAalD;;OAEG;IACH,MAAM;CAIT"}

package/build/utils/actions/pointer.js

@@ -0,0 +1,76 @@
+import BaseAction from './base.js';
+const ORIGIN_DEFAULT = 'viewport';
+const BUTTON_DEFAULT = 0;
+const POINTER_TYPE_DEFAULT = 'mouse';
+const UP_PARAM_DEFAULTS = {
+    button: BUTTON_DEFAULT
+};
+const PARAM_DEFAULTS = {
+    ...UP_PARAM_DEFAULTS,
+    width: 0,
+    height: 0,
+    pressure: 0,
+    tangentialPressure: 0,
+    tiltX: 0,
+    tiltY: 0,
+    twist: 0,
+    altitudeAngle: 0,
+    azimuthAngle: 0
+};
+const MOVE_PARAM_DEFAULTS = {
+    x: 0,
+    y: 0,
+    duration: 100,
+    origin: ORIGIN_DEFAULT
+};
+export default class PointerAction extends BaseAction {
+    constructor(instance, params = {}) {
+        if (!params.parameters) {
+            params.parameters = { pointerType: POINTER_TYPE_DEFAULT };
+        }
+        super(instance, 'pointer', params);
+    }
+    move(params = {}, y) {
+        const seq = {
+            type: 'pointerMove',
+            // default params
+            ...PARAM_DEFAULTS,
+            ...UP_PARAM_DEFAULTS,
+            ...MOVE_PARAM_DEFAULTS,
+        };
+        if (typeof params === 'number') {
+            Object.assign(seq, { x: params, y });
+        }
+        else if (params) {
+            Object.assign(seq, params);
+        }
+        this.sequence.push(seq);
+        return this;
+    }
+    up(params = UP_PARAM_DEFAULTS) {
+        this.sequence.push({
+            type: 'pointerUp',
+            button: typeof params === 'string'
+                ? params === 'right' ? 2 : (params === 'middle' ? 1 : 0)
+                : params.button
+        });
+        return this;
+    }
+    down(params = {}) {
+        this.sequence.push({
+            type: 'pointerDown',
+            ...PARAM_DEFAULTS,
+            ...(typeof params === 'string'
+                ? { button: params === 'right' ? 2 : (params === 'middle' ? 1 : 0) }
+                : params)
+        });
+        return this;
+    }
+    /**
+     * An action that cancels this pointer's current input.
+     */
+    cancel() {
+        this.sequence.push({ type: 'pointerCancel' });
+        return this;
+    }
+}

package/build/utils/actions/wheel.d.ts

@@ -0,0 +1,36 @@
+import BaseAction, { BaseActionParams } from './base.js';
+import type { ChainablePromiseElement } from '../../types';
+export interface ScrollParams {
+    /**
+     * starting x coordinate
+     */
+    x: number;
+    /**
+     * starting y coordinate
+     */
+    y: number;
+    /**
+     * Delta X to scroll to target
+     */
+    deltaX: number;
+    /**
+     * Delta Y to scroll to target
+     */
+    deltaY: number;
+    /**
+     * element origin
+     */
+    origin?: WebdriverIO.Element | ChainablePromiseElement<WebdriverIO.Element>;
+    /**
+     * duration ratio be the ratio of time delta and duration
+     */
+    duration: number;
+}
+export default class WheelAction extends BaseAction {
+    constructor(instance: WebdriverIO.Browser, params?: BaseActionParams);
+    /**
+     * Scrolls a page to given coordinates or origin.
+     */
+    scroll(params?: Partial<ScrollParams>): this;
+}
+//# sourceMappingURL=wheel.d.ts.map

package/build/utils/actions/wheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel.d.ts","sourceRoot":"","sources":["../../../src/utils/actions/wheel.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAA;IACT;;OAEG;IACH,CAAC,EAAE,MAAM,CAAA;IACT;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC3E;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACnB;AAUD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,UAAU;gBACnC,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAIpE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;CAIxC"}

package/build/utils/actions/wheel.js

@@ -0,0 +1,20 @@
+import BaseAction from './base.js';
+const DEFAULT_SCROLL_PARAMS = {
+    x: 0,
+    y: 0,
+    deltaX: 0,
+    deltaY: 0,
+    duration: 0
+};
+export default class WheelAction extends BaseAction {
+    constructor(instance, params) {
+        super(instance, 'wheel', params);
+    }
+    /**
+     * Scrolls a page to given coordinates or origin.
+     */
+    scroll(params) {
+        this.sequence.push({ type: 'scroll', ...DEFAULT_SCROLL_PARAMS, ...params });
+        return this;
+    }
+}

package/build/utils/detectBackend.d.ts

@@ -1,4 +1,4 @@
-import { Capabilities, Options } from '@wdio/types';
+import type { Capabilities, Options } from '@wdio/types';
 interface BackendConfigurations {
     port?: number;
     hostname?: string;

package/build/utils/detectBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detectBackend.d.ts","sourceRoot":"","sources":["../../src/utils/detectBackend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAiBnD,UAAU,qBAAqB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAA;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,YAAY,CAAC,kBAAkB,GAAG,YAAY,CAAC,gBAAgB,CAAA;CACjF;AAgBD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,OAAO,GAAE,qBAA0B;;;;;EAoGxE"}
+{"version":3,"file":"detectBackend.d.ts","sourceRoot":"","sources":["../../src/utils/detectBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAiBxD,UAAU,qBAAqB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAA;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,YAAY,CAAC,kBAAkB,GAAG,YAAY,CAAC,gBAAgB,CAAA;CACjF;AAgBD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,OAAO,GAAE,qBAA0B;;;;;EAoGxE"}

package/build/utils/detectBackend.js

@@ -1,5 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
 const DEFAULT_HOSTNAME = '127.0.0.1';
 const DEFAULT_PORT = 4444;
 const DEFAULT_PROTOCOL = 'http';
@@ -26,8 +24,7 @@ function getSauceEndpoint(region, { isRDC, isVisual } = {}) {
 /**
  * helper to detect the Selenium backend according to given capabilities
  */
-function detectBackend(options = {}) {
-    var _a;
+export default function detectBackend(options = {}) {
     let { port, hostname, user, key, protocol, region, headless, path, capabilities } = options;
     /**
      * browserstack
@@ -60,8 +57,8 @@ function detectBackend(options = {}) {
      * For Sauce Labs Legacy RDC we only need to determine if the sauce option has a `testobject_api_key`.
      * Same for Sauce Visual where an apiKey can be passed in through the capabilities (soon to be legacy too).
      */
-    const isRDC = Boolean(!Array.isArray(capabilities) && (capabilities === null || capabilities === void 0 ? void 0 : capabilities.testobject_api_key));
-    const isVisual = Boolean(!Array.isArray(capabilities) && capabilities && ((_a = capabilities['sauce:visual']) === null || _a === void 0 ? void 0 : _a.apiKey));
+    const isRDC = Boolean(!Array.isArray(capabilities) && capabilities?.testobject_api_key);
+    const isVisual = Boolean(!Array.isArray(capabilities) && capabilities && capabilities['sauce:visual']?.apiKey);
     if ((typeof user === 'string' && typeof key === 'string' && key.length === 36) ||
         // Or only RDC or visual
         (isRDC || isVisual)) {
@@ -116,4 +113,3 @@ function detectBackend(options = {}) {
      */
     return { hostname, port, protocol, path };
 }
-exports.default = detectBackend;

package/build/utils/findStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findStrategy.d.ts","sourceRoot":"","sources":["../../src/utils/findStrategy.ts"],"names":[],"mappings":"AA4BA,aAAK,gBAAgB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAuF/D,eAAO,MAAM,YAAY,aAAuB,gBAAgB,UAAU,OAAO,aAAa,OAAO;;;CAoIpG,CAAA"}
+{"version":3,"file":"findStrategy.d.ts","sourceRoot":"","sources":["../../src/utils/findStrategy.ts"],"names":[],"mappings":"AA4BA,aAAK,gBAAgB,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AA2F/D,eAAO,MAAM,YAAY,aAAuB,gBAAgB,UAAU,OAAO,aAAa,OAAO;;;CAuKpG,CAAA"}

package/build/utils/findStrategy.js

@@ -1,13 +1,7 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findStrategy = void 0;
-const fs_1 = __importDefault(require("fs"));
-const lodash_isplainobject_1 = __importDefault(require("lodash.isplainobject"));
-const aria_query_1 = require("aria-query");
-const constants_1 = require("../constants");
+import fs from 'node:fs';
+import isPlainObject from 'lodash.isplainobject';
+import { roleElements } from 'aria-query';
+import { DEEP_SELECTOR, ARIA_SELECTOR } from '../constants.js';
 const DEFAULT_STRATEGY = 'css selector';
 const DIRECT_SELECTOR_REGEXP = /^(id|css selector|xpath|link text|partial link text|name|tag name|class name|-android uiautomator|-android datamatcher|-android viewmatcher|-android viewtag|-ios uiautomation|-ios predicate string|-ios class chain|accessibility id):(.+)/;
 const XPATH_SELECTORS_START = [
@@ -34,7 +28,7 @@ const defineStrategy = function (selector) {
     // in case of "selector" argument is a plain object then .match() will cause
     // an error like "selector.match is not a function"
     // Use '-android datamatcher' or '-android viewmatcher' strategy if selector is a plain object (Android only)
-    if ((0, lodash_isplainobject_1.default)(selector)) {
+    if (isPlainObject(selector)) {
         if (JSON.stringify(selector).indexOf('test.espresso.matcher.ViewMatchers') < 0)
             return '-android datamatcher';
         return '-android viewmatcher';
@@ -68,9 +62,13 @@ const defineStrategy = function (selector) {
         return 'id';
     }
     // use shadow dom selector
-    if (stringSelector.startsWith(constants_1.DEEP_SELECTOR)) {
+    if (stringSelector.startsWith(DEEP_SELECTOR)) {
         return 'shadow';
     }
+    // use aria selector
+    if (stringSelector.startsWith(ARIA_SELECTOR)) {
+        return 'aria';
+    }
     // Recursive element search using the UiAutomator library (Android only)
     if (stringSelector.startsWith('android=')) {
         return '-android uiautomator';
@@ -113,7 +111,7 @@ const defineStrategy = function (selector) {
         return 'role';
     }
 };
-const findStrategy = function (selector, isW3C, isMobile) {
+export const findStrategy = function (selector, isW3C, isMobile) {
     const stringSelector = selector;
     let using = DEFAULT_STRATEGY;
     let value = selector;
@@ -121,7 +119,7 @@ const findStrategy = function (selector, isW3C, isMobile) {
         // user has specified locator strategy directly
         case 'directly': {
             const match = stringSelector.match(DIRECT_SELECTOR_REGEXP);
-            if (!match || !isMobile && isW3C && !constants_1.W3C_SELECTOR_STRATEGIES.includes(match[1])) {
+            if (!match) {
                 throw new Error('InvalidSelectorStrategy'); // ToDo: move error to wdio-error package
             }
             using = match[1];
@@ -149,8 +147,43 @@ const findStrategy = function (selector, isW3C, isMobile) {
         }
         case 'shadow':
             using = 'shadow';
-            value = stringSelector.slice(constants_1.DEEP_SELECTOR.length);
+            value = stringSelector.slice(DEEP_SELECTOR.length);
             break;
+        case 'aria': {
+            const label = stringSelector.slice(ARIA_SELECTOR.length);
+            const conditions = [
+                // aria label is recevied by other element with aria-labelledBy
+                // https://www.w3.org/TR/accname-1.1/#step2B
+                `.//*[@aria-labelledby=(//*[normalize-space() = "${label}"]/@id)]`,
+                // aria label is recevied by other element with aria-labelledBy
+                // https://www.w3.org/TR/accname-1.1/#step2B
+                `.//*[@aria-describedby=(//*[normalize-space() = "${label}"]/@id)]`,
+                // element has direct aria label
+                // https://www.w3.org/TR/accname-1.1/#step2C
+                `.//*[@aria-label = "${label}"]`,
+                // inputs with a label
+                // https://www.w3.org/TR/accname-1.1/#step2D
+                `.//input[@id = (//label[normalize-space() = "${label}"]/@for)]`,
+                // aria label is received by an input placeholder
+                // https://www.w3.org/TR/accname-1.1/#step2D
+                `.//input[@placeholder="${label}"]`,
+                // aria label is received by an input placeholder
+                // https://www.w3.org/TR/accname-1.1/#step2D
+                `.//input[@aria-placeholder="${label}"]`,
+                // aria label is received by its title attribute
+                // https://www.w3.org/TR/accname-1.1/#step2D
+                `.//*[@title="${label}"]`,
+                // images with an alt tag
+                // https://www.w3.org/TR/accname-1.1/#step2D
+                `.//img[@alt="${label}"]`,
+                // aria label is received from element content
+                // https://www.w3.org/TR/accname-1.1/#step2G
+                `.//*[normalize-space() = "${label}"]`
+            ];
+            using = 'xpath';
+            value = `(${conditions.join(' | ')})[1]`;
+            break;
+        }
         case '-android uiautomator': {
             using = '-android uiautomator';
             value = stringSelector.slice(8);
@@ -219,7 +252,7 @@ const findStrategy = function (selector, isW3C, isMobile) {
         }
         case '-image': {
             using = '-image';
-            value = fs_1.default.readFileSync(stringSelector, { encoding: 'base64' });
+            value = fs.readFileSync(stringSelector, { encoding: 'base64' });
             break;
         }
         case 'role': {
@@ -234,11 +267,9 @@ const findStrategy = function (selector, isW3C, isMobile) {
     }
     return { using, value };
 };
-exports.findStrategy = findStrategy;
 const createRoleBaseXpathSelector = (role) => {
-    var _a;
     const locatorArr = [];
-    (_a = aria_query_1.roleElements.get(role)) === null || _a === void 0 ? void 0 : _a.forEach((value) => {
+    roleElements.get(role)?.forEach((value) => {
         let locator;
         let tagname, tagAttribute, tagAttributevalue;
         tagname = value.name;

package/build/utils/getElementObject.d.ts

@@ -13,5 +13,5 @@ export declare const getElement: (this: WebdriverIO.Browser | WebdriverIO.Elemen
  * @param  {Object} res       findElements response
  * @return {Array}            array of WDIO elements
  */
-export declare const getElements: (this: WebdriverIO.Browser | WebdriverIO.Element, selector: Selector, elemResponse: ElementReference[], isReactElement?: boolean) => ElementArray;
+export declare const getElements: (this: WebdriverIO.Browser | WebdriverIO.Element, selector: Selector | ElementReference[] | WebdriverIO.Element[], elemResponse: ElementReference[], isReactElement?: boolean) => ElementArray;
 //# sourceMappingURL=getElementObject.d.ts.map

package/build/utils/getElementObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getElementObject.d.ts","sourceRoot":"","sources":["../../src/utils/getElementObject.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAKvD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SACb,YAAY,OAAO,GAAG,mBAAmB,aACpC,QAAQ,QACb,gBAAgB,GAAG,KAAK,+BAE/B,mBA8CF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,SACd,YAAY,OAAO,GAAG,mBAAmB,YACrC,QAAQ,gBACJ,gBAAgB,EAAE,+BAEjC,YA+CF,CAAA"}
+{"version":3,"file":"getElementObject.d.ts","sourceRoot":"","sources":["../../src/utils/getElementObject.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAMvD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SACb,YAAY,OAAO,GAAG,mBAAmB,aACpC,QAAQ,QACb,gBAAgB,GAAG,KAAK,+BAE/B,mBAuDF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,SACd,YAAY,OAAO,GAAG,mBAAmB,YACrC,QAAQ,GAAG,gBAAgB,EAAE,GAAG,mBAAmB,EAAE,gBACjD,gBAAgB,EAAE,+BAEjC,YAiEF,CAAA"}