@wdio/utils 8.33.1 → 8.36.0

package/build/index.d.ts

@@ -2,13 +2,13 @@ import webdriverMonad from './monad.js';
 import initializePlugin from './initializePlugin.js';
 import { startWebDriver } from './startWebDriver.js';
 import { initializeWorkerService, initializeLauncherService } from './initializeServices.js';
-import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability } from './utils.js';
+import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability, getBrowserObject } from './utils.js';
 import { wrapCommand, executeHooksWithArgs, executeAsync } from './shim.js';
 import * as asyncIterators from './pIteration.js';
 import { testFnWrapper, wrapGlobalTestMethod } from './test-framework/index.js';
 import { isW3C, capabilitiesEnvironmentDetector, sessionEnvironmentDetector, devtoolsEnvironmentDetector } from './envDetector.js';
 import { UNICODE_CHARACTERS, HOOK_DEFINITION } from './constants.js';
-export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, asyncIterators, 
+export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, getBrowserObject, asyncIterators, 
 /**
  * runner shim
  */

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,cAAc,MAAM,YAAY,CAAA;AACvC,OAAO,gBAAgB,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAC5F,OAAO,EACH,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EACnE,eAAe,EAAE,yBAAyB,EAAE,KAAK,EAAE,kBAAkB,EACxE,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC3E,OAAO,KAAK,cAAc,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EACH,KAAK,EAAE,+BAA+B,EACtC,0BAA0B,EAAE,2BAA2B,EAC1D,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,KAAK,EACL,kBAAkB,EAClB,cAAc;AAEd;;GAEG;AACH,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,oBAAoB;AAEpB;;GAEG;AACH,KAAK,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B;AAE3B;;GAEG;AACH,kBAAkB,EAClB,eAAe,EAClB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,cAAc,MAAM,YAAY,CAAA;AACvC,OAAO,gBAAgB,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AAC5F,OAAO,EACH,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EACnE,eAAe,EAAE,yBAAyB,EAAE,KAAK,EAAE,kBAAkB,EACrE,gBAAgB,EACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC3E,OAAO,KAAK,cAAc,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EACH,KAAK,EAAE,+BAA+B,EACtC,0BAA0B,EAAE,2BAA2B,EAC1D,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,KAAK,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc;AAEd;;GAEG;AACH,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,oBAAoB;AAEpB;;GAEG;AACH,KAAK,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B;AAE3B;;GAEG;AACH,kBAAkB,EAClB,eAAe,EAClB,CAAA"}

package/build/index.js

@@ -3,13 +3,13 @@ import webdriverMonad from './monad.js';
 import initializePlugin from './initializePlugin.js';
 import { startWebDriver } from './startWebDriver.js';
 import { initializeWorkerService, initializeLauncherService } from './initializeServices.js';
-import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability } from './utils.js';
+import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability, getBrowserObject } from './utils.js';
 import { wrapCommand, executeHooksWithArgs, executeAsync } from './shim.js';
 import * as asyncIterators from './pIteration.js';
 import { testFnWrapper, wrapGlobalTestMethod } from './test-framework/index.js';
 import { isW3C, capabilitiesEnvironmentDetector, sessionEnvironmentDetector, devtoolsEnvironmentDetector } from './envDetector.js';
 import { UNICODE_CHARACTERS, HOOK_DEFINITION } from './constants.js';
-export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, asyncIterators, 
+export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, getBrowserObject, asyncIterators, 
 /**
  * runner shim
  */

package/build/pIteration.d.ts

@@ -8,7 +8,7 @@
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with undefined value.
  */
-export declare const forEach: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<void>;
+export declare const forEach: <T>(array: T[], callback: Function, thisArg?: T) => Promise<void>;
 /**
  * Same functionality as [`forEach()`](global.html#forEach), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
@@ -16,7 +16,7 @@ export declare const forEach: <T>(array: T[], callback: Function, thisArg?: T |
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with undefined value.
  */
-export declare const forEachSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<void>;
+export declare const forEachSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<void>;
 /**
  * Implements ES5 [`Array#map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) method.<br><br>
  * Creates a new array with the results of calling the provided callback once for each element.<br>
@@ -28,7 +28,7 @@ export declare const forEachSeries: <T>(array: T[], callback: Function, thisArg?
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the resultant *Array* as value.
  */
-export declare const map: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<any[]>;
+export declare const map: <T>(array: T[], callback: Function, thisArg?: T) => Promise<any[]>;
 /**
  * Same functionality as [`map()`](global.html#map), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
@@ -36,7 +36,7 @@ export declare const map: <T>(array: T[], callback: Function, thisArg?: T | unde
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the resultant *Array* as value.
  */
-export declare const mapSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<any[]>;
+export declare const mapSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<any[]>;
 /**
  * Implements ES5 [`Array#find()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/find) method.<br><br>
  * Returns the value of the element that satisfies the provided `callback`. The value returned is the one found first.<br>
@@ -47,7 +47,7 @@ export declare const mapSeries: <T>(array: T[], callback: Function, thisArg?: T
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the element that passed the test as value, otherwise *undefined*.
  */
-export declare const find: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<T | undefined>;
+export declare const find: <T>(array: T[], callback: Function, thisArg?: T) => Promise<T | undefined>;
 /**
  * Same functionality as [`find()`](global.html#find), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
@@ -55,7 +55,7 @@ export declare const find: <T>(array: T[], callback: Function, thisArg?: T | und
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the element that passed the test as value, otherwise *undefined*.
  */
-export declare const findSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<T | undefined>;
+export declare const findSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<T | undefined>;
 /**
  * Implements ES5 [`Array#findIndex()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/findIndex) method.<br><br>
  * Returns the index of the element that satisfies the provided `callback`. The index returned is the one found first.<br>
@@ -66,7 +66,7 @@ export declare const findSeries: <T>(array: T[], callback: Function, thisArg?: T
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the index that passed the test as value, otherwise *-1*.
  */
-export declare const findIndex: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<unknown>;
+export declare const findIndex: <T>(array: T[], callback: Function, thisArg?: T) => Promise<unknown>;
 /**
  * Same functionality as [`findIndex()`](global.html#findIndex), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
@@ -74,7 +74,7 @@ export declare const findIndex: <T>(array: T[], callback: Function, thisArg?: T
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the index that passed the test, otherwise *-1*.
  */
-export declare const findIndexSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<number | undefined>;
+export declare const findIndexSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<number | undefined>;
 /**
  * Implements ES5 [`Array#some()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/some) method.<br><br>
  * Test if some element in `array` passes the test implemented in `callback`.<br>
@@ -85,7 +85,7 @@ export declare const findIndexSeries: <T>(array: T[], callback: Function, thisAr
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with *true* as value if some element passed the test, otherwise *false*.
  */
-export declare const some: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<unknown>;
+export declare const some: <T>(array: T[], callback: Function, thisArg?: T) => Promise<unknown>;
 /**
  * Same functionality as [`some()`](global.html#some), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
@@ -93,7 +93,7 @@ export declare const some: <T>(array: T[], callback: Function, thisArg?: T | und
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with *true* as value if some element passed the test, otherwise *false*.
  */
-export declare const someSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<boolean>;
+export declare const someSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<boolean>;
 /**
  * Implements ES5 [`Array#every()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every) method.<br><br>
  * Test if all elements in `array` pass the test implemented in `callback`.<br>
@@ -104,7 +104,7 @@ export declare const someSeries: <T>(array: T[], callback: Function, thisArg?: T
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with *true* as value if all elements passed the test, otherwise *false*.
  */
-export declare const every: <T>(array: T[], callback: any, thisArg?: T | undefined) => Promise<boolean>;
+export declare const every: <T>(array: T[], callback: any, thisArg?: T) => Promise<boolean>;
 /**
  * Same functionality as [`every()`](global.html#every), but runs only one callback at a time.<br><br>
  * @param {Array} array - Array to iterate over.
@@ -112,7 +112,7 @@ export declare const every: <T>(array: T[], callback: any, thisArg?: T | undefin
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with *true* as value if all elements passed the test, otherwise *false*.
  */
-export declare const everySeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<boolean>;
+export declare const everySeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<boolean>;
 /**
  * Implements ES5 [`Array#filter()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) method.<br><br>
  * Creates a new array with the elements that passed the test implemented in `callback`.<br>
@@ -122,14 +122,14 @@ export declare const everySeries: <T>(array: T[], callback: Function, thisArg?:
  * @param {Object} [thisArg] - Value to use as *this* when executing the `callback`.
  * @return {Promise} - Returns a Promise with the resultant filtered *Array* as value.
  */
-export declare const filter: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<unknown>;
+export declare const filter: <T>(array: T[], callback: Function, thisArg?: T) => Promise<unknown>;
 /**
  * Same functionality as [`filter()`](global.html#filter), but runs only one callback at a time.
  * @param {Array} array - Array to iterate over.
  * @param {Function} callback - Function to apply each item in `array`. Accepts three arguments: `currentValue`, `index` and `array`.
  * @return {Promise} - Returns a Promise with the resultant filtered *Array* as value.
  */
-export declare const filterSeries: <T>(array: T[], callback: Function, thisArg?: T | undefined) => Promise<Awaited<T>[]>;
+export declare const filterSeries: <T>(array: T[], callback: Function, thisArg?: T) => Promise<Awaited<T>[]>;
 /**
  * Implements ES5 [`Array#reduce()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reduce) method.<br><br>
  * Applies a `callback` against an accumulator and each element in `array`.
@@ -138,5 +138,5 @@ export declare const filterSeries: <T>(array: T[], callback: Function, thisArg?:
  * @param {Object} [initialValue] - Used as first argument to the first call of `callback`.
  * @return {Promise} - Returns a Promise with the resultant value from the reduction.
  */
-export declare const reduce: <T>(array: T[], callback: Function, initialValue?: T | undefined) => Promise<any>;
+export declare const reduce: <T>(array: T[], callback: Function, initialValue?: T) => Promise<any>;
 //# sourceMappingURL=pIteration.d.ts.map

package/build/pIteration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pIteration.d.ts","sourceRoot":"","sources":["../src/pIteration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,4BAAmC,QAAQ,2CAW9D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,4BAAmC,QAAQ,2CAMpE,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,4BAAmC,QAAQ,4CAU1D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,4BAAmC,QAAQ,4CAQhE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,4BAA6B,QAAQ,oDAqBrD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,4BAAmC,QAAQ,oDAMjE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,4BAA6B,QAAQ,8CAqB1D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,4BAAmC,QAAQ,yDAMtE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,4BAA6B,QAAQ,8CAyBrD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,4BAAmC,QAAQ,8CAOjE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,4BAA6B,GAAG,8CAyBjD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,4BAAmC,QAAQ,8CAOlE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,4BAA6B,QAAQ,8CAwBvD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,4BAAmC,QAAQ,mDAQnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,4BAAmC,QAAQ,+CAmB7D,CAAA"}
+{"version":3,"file":"pIteration.d.ts","sourceRoot":"","sources":["../src/pIteration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,kBAW3E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,kBAMjF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,mBAUvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,mBAQ7E,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,aAAc,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,2BAqBlE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,2BAM9E,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,aAAc,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,qBAqBvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,gCAMnF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,aAAc,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,qBAyBlE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,qBAO9E,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,aAAc,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC,qBAyB9D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,qBAO/E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,aAAc,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,qBAwBpE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,aAAoB,CAAC,EAAE,YAAY,QAAQ,YAAY,CAAC,0BAQhF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,aAAoB,CAAC,EAAE,YAAY,QAAQ,iBAAiB,CAAC,iBAmB/E,CAAA"}

package/build/shim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,aAAa,CAAA;AAqBtD,wBAAsB,oBAAoB,CAAC,CAAC,EAAG,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,QAAQ,GAAG,QAAQ,EAAO,EAAE,IAAI,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CA4DvJ;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAmM9F;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE,IAAI,GAAE,GAAG,EAAO,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA2CxJ"}
+{"version":3,"file":"shim.d.ts","sourceRoot":"","sources":["../src/shim.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,aAAa,CAAA;AAsBtD,wBAAsB,oBAAoB,CAAC,CAAC,EAAG,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,QAAQ,GAAG,QAAQ,EAAO,EAAE,IAAI,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CA4DvJ;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAqN9F;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE,IAAI,GAAE,GAAG,EAAO,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA2CxJ"}

package/build/shim.js

@@ -1,5 +1,7 @@
+/// <reference types="@wdio/globals/types" />
 import logger from '@wdio/logger';
 import * as iterators from './pIteration.js';
+import { getBrowserObject } from './utils.js';
 const log = logger('@wdio/utils:shim');
 let inCommandHook = false;
 const ELEMENT_QUERY_COMMANDS = [
@@ -136,9 +138,26 @@ export function wrapCommand(commandName, fn) {
                      * `this` is an array of WebdriverIO elements
                      *
                      * Note(Christian): types for elements are defined in the
-                     * webdriverio package and not accessible here
+                     * webdriverio package and not accessible here (fixed in v9)
                      */
                     function (index) {
+                        /**
+                         * if we access an index that is out of bounds we wait for the
+                         * array to get that long, and timeout eventually if it doesn't
+                         */
+                        if (index >= this.length) {
+                            const browser = getBrowserObject(this);
+                            return browser.waitUntil(async () => {
+                                const elems = await this.parent[this.foundWith](this.selector);
+                                if (elems.length > index) {
+                                    return elems[index];
+                                }
+                                return false;
+                            }, {
+                                timeout: browser.options.waitforTimeout,
+                                timeoutMsg: `Index out of bounds! $$(${this.selector}) returned only ${this.length} elements.`
+                            });
+                        }
                         return this[index];
                     }, [prop], { prop, args });
                 }

package/build/utils.d.ts

@@ -88,4 +88,8 @@ export declare function isChrome(browserName?: string): boolean;
 export declare function isSafari(browserName?: string): boolean;
 export declare function isFirefox(browserName?: string): boolean;
 export declare function isEdge(browserName?: string): boolean;
+/**
+ * traverse up the scope chain until browser element was reached
+ */
+export declare function getBrowserObject(elem: WebdriverIO.Element | WebdriverIO.Browser): WebdriverIO.Browser;
 //# sourceMappingURL=utils.d.ts.map

package/build/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAW,MAAM,aAAa,CAAA;AAe7D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAGnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE;IAAE,sBAAsB,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAwCzH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,UAAQ,UA+BrF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAE,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;EAapF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,WA8B/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAE,GAAG,EAAE,GAAG,wGAExC;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,CAgEtF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAE,EAAE,EAAE,QAAQ,WAE5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAE,IAAI,EAAE,GAAG,EAAE,SAE1C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,WAenC;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,mCAAoD,CAAA;AAEtE;;;;;EAKE;AACF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAM1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,WAQ/H;AAED,wBAAgB,QAAQ,CAAE,WAAW,CAAC,EAAE,MAAM,WAE7C;AACD,wBAAgB,QAAQ,CAAE,WAAW,CAAC,EAAE,MAAM,WAE7C;AACD,wBAAgB,SAAS,CAAE,WAAW,CAAC,EAAE,MAAM,WAE9C;AACD,wBAAgB,MAAM,CAAE,WAAW,CAAC,EAAE,MAAM,WAE3C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAW,MAAM,aAAa,CAAA;AAe7D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,WAGnC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE;IAAE,sBAAsB,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAwCzH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,UAAQ,UA+BrF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAE,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;EAapF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,WA8B/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAE,GAAG,EAAE,GAAG,wGAExC;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,CAgEtF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAE,EAAE,EAAE,QAAQ,WAE5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAE,IAAI,EAAE,GAAG,EAAE,SAE1C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,WAenC;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK,mCAAoD,CAAA;AAEtE;;;;;EAKE;AACF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAM1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,WAQ/H;AAED,wBAAgB,QAAQ,CAAE,WAAW,CAAC,EAAE,MAAM,WAE7C;AACD,wBAAgB,QAAQ,CAAE,WAAW,CAAC,EAAE,MAAM,WAE7C;AACD,wBAAgB,SAAS,CAAE,WAAW,CAAC,EAAE,MAAM,WAE9C;AACD,wBAAgB,MAAM,CAAE,WAAW,CAAC,EAAE,MAAM,WAE3C;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAKtG"}

package/build/utils.js

@@ -300,3 +300,13 @@ export function isFirefox(browserName) {
 export function isEdge(browserName) {
     return Boolean(browserName && SUPPORTED_BROWSERNAMES.edge.includes(browserName.toLowerCase()));
 }
+/**
+ * traverse up the scope chain until browser element was reached
+ */
+// @ts-ignore types are not loaded in time (fixed in v9)
+export function getBrowserObject(elem) {
+    // @ts-ignore types are not loaded in time (fixed in v9)
+    const elemObject = elem;
+    // @ts-ignore types are not loaded in time (fixed in v9)
+    return elemObject.parent ? getBrowserObject(elemObject.parent) : elem;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdio/utils",
-  "version": "8.33.1",
+  "version": "8.36.0",
   "description": "A WDIO helper utility to provide several utility functions used across the project.",
   "author": "Christian Bromann <mail@bromann.dev>",
   "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-utils",
@@ -39,7 +39,7 @@
   "dependencies": {
     "@puppeteer/browsers": "^1.6.0",
     "@wdio/logger": "8.28.0",
-    "@wdio/types": "8.32.4",
+    "@wdio/types": "8.36.0",
     "decamelize": "^6.0.0",
     "deepmerge-ts": "^5.1.0",
     "edgedriver": "^5.3.5",
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "6ee4cdd36e9f10541ede896d18b785ac9c56dacf"
+  "gitHead": "bc4e87f18f8f3cd8293734264f3ffb1e6a194cd7"
 }