@wdio/utils 8.22.0 → 8.23.1

package/build/index.d.ts

@@ -1,13 +1,13 @@
 import webdriverMonad from './monad.js';
-import initialisePlugin from './initialisePlugin.js';
+import initializePlugin from './initializePlugin.js';
 import { startWebDriver } from './startWebDriver.js';
-import { initialiseWorkerService, initialiseLauncherService } from './initialiseServices.js';
+import { initializeWorkerService, initializeLauncherService } from './initializeServices.js';
 import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability } from './utils.js';
 import { wrapCommand, executeHooksWithArgs, executeAsync } from './shim.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, initialisePlugin, initialiseLauncherService, initialiseWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, 
+export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, 
 /**
  * runner shim
  */

package/build/index.js

@@ -1,14 +1,14 @@
 /* istanbul ignore file */
 import webdriverMonad from './monad.js';
-import initialisePlugin from './initialisePlugin.js';
+import initializePlugin from './initializePlugin.js';
 import { startWebDriver } from './startWebDriver.js';
-import { initialiseWorkerService, initialiseLauncherService } from './initialiseServices.js';
+import { initializeWorkerService, initializeLauncherService } from './initializeServices.js';
 import { commandCallStructure, isValidParameter, getArgumentType, safeImport, isFunctionAsync, transformCommandLogResult, sleep, isAppiumCapability } from './utils.js';
 import { wrapCommand, executeHooksWithArgs, executeAsync } from './shim.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, initialisePlugin, initialiseLauncherService, initialiseWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, 
+export { startWebDriver, initializePlugin, initializeLauncherService, initializeWorkerService, isFunctionAsync, transformCommandLogResult, webdriverMonad, commandCallStructure, isValidParameter, getArgumentType, safeImport, sleep, isAppiumCapability, 
 /**
  * runner shim
  */

package/build/{initialisePlugin.d.ts → initializePlugin.d.ts}

@@ -1,9 +1,9 @@
 import type { Services } from '@wdio/types';
 /**
- * initialise WebdriverIO compliant plugins like reporter or services in the following way:
+ * initialize WebdriverIO compliant plugins like reporter or services in the following way:
  * 1. if package name is scoped (starts with "@"), require scoped package name
  * 2. otherwise try to require "@wdio/<name>-<type>"
  * 3. otherwise try to require "wdio-<name>-<type>"
  */
-export default function initialisePlugin(name: string, type?: string): Promise<Services.ServicePlugin | Services.RunnerPlugin>;
-//# sourceMappingURL=initialisePlugin.d.ts.map
+export default function initializePlugin(name: string, type?: string): Promise<Services.ServicePlugin | Services.RunnerPlugin>;
+//# sourceMappingURL=initializePlugin.d.ts.map

package/build/initializePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializePlugin.d.ts","sourceRoot":"","sources":["../src/initializePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C;;;;;GAKG;AACH,wBAA8B,gBAAgB,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,YAAY,CAAC,CAqCpI"}

package/build/{initialisePlugin.js → initializePlugin.js}

@@ -1,11 +1,11 @@
 import { safeImport, isAbsolute } from './utils.js';
 /**
- * initialise WebdriverIO compliant plugins like reporter or services in the following way:
+ * initialize WebdriverIO compliant plugins like reporter or services in the following way:
  * 1. if package name is scoped (starts with "@"), require scoped package name
  * 2. otherwise try to require "@wdio/<name>-<type>"
  * 3. otherwise try to require "wdio-<name>-<type>"
  */
-export default async function initialisePlugin(name, type) {
+export default async function initializePlugin(name, type) {
     /**
      * directly import packages that are scoped or start with an absolute path
      */

package/build/{initialiseServices.d.ts → initializeServices.d.ts}

@@ -1,23 +1,23 @@
 import type { Capabilities, Services, Options } from '@wdio/types';
 /**
- * initialise service for launcher process
+ * initialize service for launcher process
  * @param  {Object}   config  wdio config
  * @param  {Object[]} caps    list of capabilities
  * @return {Object}           containing a list of launcher services as well
  *                            as a list of services that don't need to be
  *                            required in the worker
  */
-export declare function initialiseLauncherService(config: Omit<Options.Testrunner, 'capabilities' | keyof Services.HookFunctions>, caps: Capabilities.DesiredCapabilities): Promise<{
+export declare function initializeLauncherService(config: Omit<Options.Testrunner, 'capabilities' | keyof Services.HookFunctions>, caps: Capabilities.DesiredCapabilities): Promise<{
     ignoredWorkerServices: string[];
     launcherServices: Services.ServiceInstance[];
 }>;
 /**
- * initialise services for worker instance
+ * initialize services for worker instance
  * @param  {Object} config                 wdio config
  * @param  {Object} caps                   worker capabilities
  * @param  {object} ignoredWorkerServices  list of services that don't need to be required in a worker
  *                                         as they don't export a service for it
  * @return {Object[]}                      list if worker initiated worker services
  */
-export declare function initialiseWorkerService(config: Options.Testrunner, caps: Capabilities.DesiredCapabilities, ignoredWorkerServices?: string[]): Promise<Services.ServiceInstance[]>;
-//# sourceMappingURL=initialiseServices.d.ts.map
+export declare function initializeWorkerService(config: Options.Testrunner, caps: Capabilities.DesiredCapabilities, ignoredWorkerServices?: string[]): Promise<Services.ServiceInstance[]>;
+//# sourceMappingURL=initializeServices.d.ts.map

package/build/{initialiseServices.d.ts.map → initializeServices.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"initialiseServices.d.ts","sourceRoot":"","sources":["../src/initialiseServices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAqFlE;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,mBAAmB;;;GAmDvK;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,YAAY,CAAC,mBAAmB,EACtC,qBAAqB,GAAE,MAAM,EAAO,GACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CA+BrC"}
+{"version":3,"file":"initializeServices.d.ts","sourceRoot":"","sources":["../src/initializeServices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAqFlE;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,mBAAmB;;;GAmDvK;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,CAAC,UAAU,EAC1B,IAAI,EAAE,YAAY,CAAC,mBAAmB,EACtC,qBAAqB,GAAE,MAAM,EAAO,GACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CA+BrC"}

package/build/{initialiseServices.js → initializeServices.js}

@@ -1,17 +1,17 @@
 import logger from '@wdio/logger';
-import initialisePlugin from './initialisePlugin.js';
-const log = logger('@wdio/utils:initialiseServices');
+import initializePlugin from './initializePlugin.js';
+const log = logger('@wdio/utils:initializeServices');
 /**
  * Maps list of services of a config file into a list of actionable objects
  * @param  {Object}    config            config of running session
  * @param  {Object}    caps              capabilities of running session
  * @return {[(Object|Class), Object][]}  list of services with their config objects
  */
-async function initialiseServices(services) {
-    const initialisedServices = [];
+async function initializeServices(services) {
+    const initializedServices = [];
     for (const [serviceName, serviceConfig = {}] of services) {
         /**
-         * allow custom services that are already initialised, e.g.
+         * allow custom services that are already initialized, e.g.
          *
          * ```
          * services: [
@@ -20,8 +20,8 @@ async function initialiseServices(services) {
          * ```
          */
         if (typeof serviceName === 'object') {
-            log.debug('initialise custom initiated service');
-            initialisedServices.push([serviceName, {}]);
+            log.debug('initialize custom initiated service');
+            initializedServices.push([serviceName, {}]);
             continue;
         }
         /**
@@ -38,8 +38,8 @@ async function initialiseServices(services) {
          * ```
          */
         if (typeof serviceName === 'function') {
-            log.debug(`initialise custom service "${serviceName.name}"`);
-            initialisedServices.push([serviceName, serviceConfig]);
+            log.debug(`initialize custom service "${serviceName.name}"`);
+            initializedServices.push([serviceName, serviceConfig]);
             continue;
         }
         /**
@@ -49,11 +49,11 @@ async function initialiseServices(services) {
          * services: ['@wdio/devtools-service']
          * ```
          */
-        log.debug(`initialise service "${serviceName}" as NPM package`);
-        const service = await initialisePlugin(serviceName, 'service');
-        initialisedServices.push([service, serviceConfig, serviceName]);
+        log.debug(`initialize service "${serviceName}" as NPM package`);
+        const service = await initializePlugin(serviceName, 'service');
+        initializedServices.push([service, serviceConfig, serviceName]);
     }
-    return initialisedServices;
+    return initializedServices;
 }
 /**
  * formats service array into proper structure which is an array with
@@ -66,19 +66,19 @@ function sanitizeServiceArray(service) {
     return Array.isArray(service) ? service : [service, {}];
 }
 /**
- * initialise service for launcher process
+ * initialize service for launcher process
  * @param  {Object}   config  wdio config
  * @param  {Object[]} caps    list of capabilities
  * @return {Object}           containing a list of launcher services as well
  *                            as a list of services that don't need to be
  *                            required in the worker
  */
-export async function initialiseLauncherService(config, caps) {
+export async function initializeLauncherService(config, caps) {
     const ignoredWorkerServices = [];
     const launcherServices = [];
     let serviceLabelToBeInitialised = 'unknown';
     try {
-        const services = await initialiseServices(config.services.map(sanitizeServiceArray));
+        const services = await initializeServices(config.services.map(sanitizeServiceArray));
         for (const [service, serviceConfig, serviceName] of services) {
             /**
              * add custom services as object or function
@@ -120,38 +120,38 @@ export async function initialiseLauncherService(config, caps) {
     return { ignoredWorkerServices, launcherServices };
 }
 /**
- * initialise services for worker instance
+ * initialize services for worker instance
  * @param  {Object} config                 wdio config
  * @param  {Object} caps                   worker capabilities
  * @param  {object} ignoredWorkerServices  list of services that don't need to be required in a worker
  *                                         as they don't export a service for it
  * @return {Object[]}                      list if worker initiated worker services
  */
-export async function initialiseWorkerService(config, caps, ignoredWorkerServices = []) {
+export async function initializeWorkerService(config, caps, ignoredWorkerServices = []) {
     let serviceLabelToBeInitialised = 'unknown';
-    const initialisedServices = [];
+    const initializedServices = [];
     const workerServices = config.services
         .map(sanitizeServiceArray)
         .filter(([serviceName]) => !ignoredWorkerServices.includes(serviceName));
     try {
-        const services = await initialiseServices(workerServices);
+        const services = await initializeServices(workerServices);
         for (const [service, serviceConfig, serviceName] of services) {
             /**
              * add object service
              */
             if (typeof service === 'object' && !serviceName) {
                 serviceLabelToBeInitialised = 'object';
-                initialisedServices.push(service);
+                initializedServices.push(service);
                 continue;
             }
             const Service = service.default || service;
             if (typeof Service === 'function') {
                 serviceLabelToBeInitialised = serviceName || Service.constructor?.name || Service.toString();
-                initialisedServices.push(new Service(serviceConfig, caps, config));
+                initializedServices.push(new Service(serviceConfig, caps, config));
                 continue;
             }
         }
-        return initialisedServices;
+        return initializedServices;
     }
     catch (err) {
         throw new Error(`Failed to initilialise service ${serviceLabelToBeInitialised}: ${err.stack}`);

package/build/monad.d.ts

@@ -1,11 +1,8 @@
-import { EventEmitter } from 'node:events';
 interface PropertiesObject {
     [key: string | symbol]: PropertyDescriptor;
 }
 export default function WebDriver(options: Record<string, any>, modifier?: Function, propertiesObject?: PropertiesObject): {
-    (this: void, sessionId: string, commandWrapper?: Function, eventMiddleware?: {
-        socket: Partial<EventEmitter>;
-    }): any;
+    (this: void, sessionId: string, commandWrapper?: Function): any;
     /**
      * Enhance monad prototype with function
      * @param  {string}   name          name of function to attach to prototype

package/build/monad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monad.d.ts","sourceRoot":"","sources":["../src/monad.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAU1C,UAAU,gBAAgB;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAAA;CAC7C;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAE,gBAAqB;WAkBpG,IAAI,aAAa,MAAM,mBAAmB,QAAQ,oBAAoB;QAAE,MAAM,EAAE,QAAQ,YAAY,CAAC,CAAA;KAAE;IAmH5H;;;;;;OAMG;eACyB,MAAM,QAAQ,QAAQ,SAAS,OAAO,MAAM,EAAE,GAAG,CAAC,gBAAgB,QAAQ;EAmDzG"}
+{"version":3,"file":"monad.d.ts","sourceRoot":"","sources":["../src/monad.ts"],"names":[],"mappings":"AAYA,UAAU,gBAAgB;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,CAAA;CAC7C;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,gBAAgB,GAAE,gBAAqB;WAkBpG,IAAI,aAAa,MAAM,mBAAmB,QAAQ;IA+GvE;;;;;;OAMG;eACyB,MAAM,QAAQ,QAAQ,SAAS,OAAO,MAAM,EAAE,GAAG,CAAC,gBAAgB,QAAQ;EA6CzG"}

package/build/monad.js

@@ -20,10 +20,7 @@ export default function WebDriver(options, modifier, propertiesObject = {}) {
     /**
      * WebDriver monad
      */
-    function unit(sessionId, commandWrapper, eventMiddleware) {
-        if (eventMiddleware) {
-            prototype.eventMiddleware = eventMiddleware;
-        }
+    function unit(sessionId, commandWrapper) {
         /**
          * capabilities attached to the instance prototype not being shown if
          * logging the instance
@@ -168,11 +165,6 @@ export default function WebDriver(options, modifier, propertiesObject = {}) {
         prototype[eventCommand] = function (...args) {
             const method = eventCommand;
             eventHandler[method]?.(...args);
-            if (prototype.eventMiddleware) {
-                if (typeof prototype.eventMiddleware[method] === 'function') {
-                    prototype.eventMiddleware.socket[method](...args);
-                }
-            }
             return this;
         };
     }

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/node/utils.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAK1C;;;;GAIG;AACH,eAAO,MAAM,SAAS,UAAW,MAAM,YAWtC,CAAA;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,YAYvD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,sBAqBzD;AAED,wBAAsB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,+BAiBjE;AAGD,eAAO,MAAM,wBAAwB,aAAc,MAAM,mBAAmB,MAAM,cAAc,MAAM,SAOrG,CAAA;AAwBD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,YAAY;;;;;;GA2G3F;AAED,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,WAAW,CAAC,YAAY,oGAS/D;AAED,wBAAgB,WAAW,CAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,YAAY,UAGxG;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAC,MAAM,UAM3D;AAED,wBAAsB,iBAAiB,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;;GAgDhF;AAED,wBAAgB,gBAAgB,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,mBAEzE;AAED,wBAAgB,eAAe,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,mBAExE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/node/utils.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAK1C;;;;GAIG;AACH,eAAO,MAAM,SAAS,UAAW,MAAM,YAWtC,CAAA;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,YAYvD;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,sBAqBzD;AAED,wBAAsB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,+BAiBjE;AAGD,eAAO,MAAM,wBAAwB,aAAc,MAAM,mBAAmB,MAAM,cAAc,MAAM,SAOrG,CAAA;AA+BD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,YAAY;;;;;;GA2G3F;AAED,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,WAAW,CAAC,YAAY,oGAS/D;AAED,wBAAgB,WAAW,CAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,YAAY,UAGxG;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAC,MAAM,UAM3D;AAED,wBAAsB,iBAAiB,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;;GAgDhF;AAED,wBAAgB,gBAAgB,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,mBAEzE;AAED,wBAAgB,eAAe,CAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,mBAExE"}

package/build/node/utils.js

@@ -98,8 +98,15 @@ export const downloadProgressCallback = (artifact, downloadedBytes, totalBytes)
  * @param {InstallOptions & { unpack?: true | undefined }} args - An object containing installation options and an optional `unpack` flag.
  * @returns {Promise<void>} A Promise that resolves once the package is installed and clear the progress log.
  */
-const _install = async (args) => {
-    await install(args);
+const _install = async (args, retry = false) => {
+    await install(args).catch((err) => {
+        const error = `Failed downloading ${args.browser} v${args.buildId}: ${err.message}, retrying ...`;
+        if (retry) {
+            throw new Error(error);
+        }
+        log.error(error);
+        return _install(args, true);
+    });
     log.progress('');
 };
 function locateChromeSafely() {

package/build/test-framework/testFnWrapper.d.ts

@@ -8,10 +8,11 @@ import type { WrapperMethods, SpecFunction, BeforeHookParam, AfterHookParam } fr
  * @param   {object} after          afterFn and afterFnArgs
  * @param   {string} cid            cid
  * @param   {number} repeatTest     number of retries if test fails
- * @return  {*}                     specFn result
  * @param   {string} hookName       the hook name
+ * @param   {number} timeout        the maximum time (in milliseconds) to wait for
+ * @return  {*}                     specFn result
  */
-export declare const testFnWrapper: (this: unknown, args_0: string, args_1: SpecFunction, args_2: BeforeHookParam<unknown>, args_3: AfterHookParam<unknown>, args_4: string, args_5: number, args_6?: string | undefined) => Promise<unknown>;
+export declare const testFnWrapper: (this: unknown, args_0: string, args_1: SpecFunction, args_2: BeforeHookParam<unknown>, args_3: AfterHookParam<unknown>, args_4: string, args_5: number, args_6?: string | undefined, args_7?: number | undefined) => Promise<unknown>;
 /**
  * wraps test framework spec/hook function with WebdriverIO before/after hooks
  *
@@ -22,10 +23,11 @@ export declare const testFnWrapper: (this: unknown, args_0: string, args_1: Spec
  * @param   {object} after          afterFn and afterFnArgs function
  * @param   {string} cid            cid
  * @param   {number} repeatTest     number of retries if test fails
- * @return  {*}                     specFn result
  * @param   {string} hookName       the hook name
+ * @param   {number} timeout        the maximum time (in milliseconds) to wait for
+ * @return  {*}                     specFn result
  */
-export declare const testFrameworkFnWrapper: (this: unknown, { executeHooksWithArgs, executeAsync }: WrapperMethods, type: string, { specFn, specFnArgs }: SpecFunction, { beforeFn, beforeFnArgs }: BeforeHookParam<unknown>, { afterFn, afterFnArgs }: AfterHookParam<unknown>, cid: string, repeatTest?: number, hookName?: string) => Promise<unknown>;
+export declare const testFrameworkFnWrapper: (this: unknown, { executeHooksWithArgs, executeAsync }: WrapperMethods, type: string, { specFn, specFnArgs }: SpecFunction, { beforeFn, beforeFnArgs }: BeforeHookParam<unknown>, { afterFn, afterFnArgs }: AfterHookParam<unknown>, cid: string, repeatTest?: number, hookName?: string, timeout?: number) => Promise<unknown>;
 /**
  * Filter out internal stacktraces. exporting to allow testing of the function
  * @param   {string} stack Stacktrace

package/build/test-framework/testFnWrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testFnWrapper.d.ts","sourceRoot":"","sources":["../../src/test-framework/testFnWrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,YAAY,CAAA;AASnB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,SAChB,OAAO,2LAYhB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,SACzB,OAAO,0CAC2B,cAAc,QAChD,MAAM,0BACY,YAAY,8BACR,gBAAgB,OAAO,CAAC,4BAC1B,eAAe,OAAO,CAAC,OAC5C,MAAM,kCAEA,MAAM,qBA0CpB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MAKhD,CAAA"}
+{"version":3,"file":"testFnWrapper.d.ts","sourceRoot":"","sources":["../../src/test-framework/testFnWrapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACjB,MAAM,YAAY,CAAA;AASnB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,SAChB,OAAO,wNAahB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,SACzB,OAAO,0CAC2B,cAAc,QAChD,MAAM,0BACY,YAAY,8BACR,gBAAgB,OAAO,CAAC,4BAC1B,eAAe,OAAO,CAAC,OAC5C,MAAM,kCAEA,MAAM,YACP,MAAM,qBA0CnB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MAKhD,CAAA"}

package/build/test-framework/testFnWrapper.js

@@ -15,8 +15,9 @@ const STACKTRACE_FILTER = [
  * @param   {object} after          afterFn and afterFnArgs
  * @param   {string} cid            cid
  * @param   {number} repeatTest     number of retries if test fails
- * @return  {*}                     specFn result
  * @param   {string} hookName       the hook name
+ * @param   {number} timeout        the maximum time (in milliseconds) to wait for
+ * @return  {*}                     specFn result
  */
 export const testFnWrapper = function (...args) {
     return testFrameworkFnWrapper.call(this, { executeHooksWithArgs, executeAsync }, ...args);
@@ -31,10 +32,11 @@ export const testFnWrapper = function (...args) {
  * @param   {object} after          afterFn and afterFnArgs function
  * @param   {string} cid            cid
  * @param   {number} repeatTest     number of retries if test fails
- * @return  {*}                     specFn result
  * @param   {string} hookName       the hook name
+ * @param   {number} timeout        the maximum time (in milliseconds) to wait for
+ * @return  {*}                     specFn result
  */
-export const testFrameworkFnWrapper = async function ({ executeHooksWithArgs, executeAsync }, type, { specFn, specFnArgs }, { beforeFn, beforeFnArgs }, { afterFn, afterFnArgs }, cid, repeatTest = 0, hookName) {
+export const testFrameworkFnWrapper = async function ({ executeHooksWithArgs, executeAsync }, type, { specFn, specFnArgs }, { beforeFn, beforeFnArgs }, { afterFn, afterFnArgs }, cid, repeatTest = 0, hookName, timeout) {
     const retries = { attempts: 0, limit: repeatTest };
     const beforeArgs = beforeFnArgs(this);
     if (type === 'Hook' && hookName) {
@@ -45,7 +47,7 @@ export const testFrameworkFnWrapper = async function ({ executeHooksWithArgs, ex
     let error;
     const testStart = Date.now();
     try {
-        result = await executeAsync.call(this, specFn, retries, specFnArgs);
+        result = await executeAsync.call(this, specFn, retries, specFnArgs, timeout);
     }
     catch (err) {
         if (err.stack) {

package/build/utils.js

@@ -220,7 +220,7 @@ export async function safeImport(name) {
         return pkg;
     }
     catch (e) {
-        throw new Error(`Couldn't initialise "${name}".\n${e.stack}`);
+        throw new Error(`Couldn't initialize "${name}".\n${e.stack}`);
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdio/utils",
-  "version": "8.22.0",
+  "version": "8.23.1",
   "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.16.17",
-    "@wdio/types": "8.21.0",
+    "@wdio/types": "8.23.1",
     "decamelize": "^6.0.0",
     "deepmerge-ts": "^5.1.0",
     "edgedriver": "^5.3.5",
@@ -55,5 +55,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "81496a30b1c50e7d4129be6997f1a557f9659224"
+  "gitHead": "64633b802ba4d00d23f6531dadc3fc724d8d7dd5"
 }

package/build/initialisePlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initialisePlugin.d.ts","sourceRoot":"","sources":["../src/initialisePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAI3C;;;;;GAKG;AACH,wBAA8B,gBAAgB,CAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,YAAY,CAAC,CAqCpI"}