codeceptjs 4.0.1-beta.18 → 4.0.1-beta.19

package/typings/types.d.ts

@@ -1141,10 +1141,25 @@ declare namespace CodeceptJS {
          * I.selectOption({css: 'form select[name=account]'}, 'Premium');
          * ```
          *
+         * You can also use ARIA role locators:
+         *
+         * ```js
+         * I.selectOption({ role: 'combobox', name: 'Country' }, 'United States');
+         * I.selectOption({ role: 'listbox', name: 'options' }, 'Option 1');
+         * ```
+         *
+         * Or JSON string locators:
+         *
+         * ```js
+         * I.selectOption('{"role": "combobox", "name": "Country"}', 'United States');
+         * I.selectOption('{"role": "listbox", "name": "options"}', 'Option 1');
+         * ```
+         *
          * Provide an array for the second argument to select multiple options.
          *
          * ```js
          * I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+         * I.selectOption({ role: 'combobox', name: 'OS' }, ['Android', 'iOS']);
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
@@ -1756,28 +1771,28 @@ declare namespace CodeceptJS {
          */
         seeResponseEquals(resp: any): void;
         /**
-         * Validates JSON structure of response using [joi library](https://joi.dev).
-         * See [joi API](https://joi.dev/api/) for complete reference on usage.
+         * Validates JSON structure of response using [Zod library](https://zod.dev).
+         * See [Zod API](https://zod.dev/) for complete reference on usage.
          *
-         * Use pre-initialized joi instance by passing function callback:
+         * Use pre-initialized Zod instance by passing function callback:
          *
          * ```js
          * // response.data is { name: 'jon', id: 1 }
          *
-         * I.seeResponseMatchesJsonSchema(joi => {
-         *   return joi.object({
-         *     name: joi.string(),
-         *     id: joi.number()
+         * I.seeResponseMatchesJsonSchema(z => {
+         *   return z.object({
+         *     name: z.string(),
+         *     id: z.number()
          *   })
          * });
          *
          * // or pass a valid schema
-         * const joi = require('joi');
+         * import { z } from 'zod';
          *
-         * I.seeResponseMatchesJsonSchema(joi.object({
-         *   name: joi.string(),
-         *   id: joi.number();
-         * });
+         * I.seeResponseMatchesJsonSchema(z.object({
+         *   name: z.string(),
+         *   id: z.number()
+         * }));
          * ```
          */
         seeResponseMatchesJsonSchema(fnOrSchema: any): void;
@@ -1790,8 +1805,6 @@ declare namespace CodeceptJS {
      * @property [host = "0.0.0.0"] - Mock server host
      * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
      */
-    // @ts-ignore
-    // @ts-ignore
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -1916,8 +1929,6 @@ declare namespace CodeceptJS {
      *
      * ## Methods
      */
-    // @ts-ignore
-    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -2013,9 +2024,14 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [recordHar] - record HAR and will be saved to `output/har`. See more of [HAR options](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har).
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
+     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(`[role="${selector}"]`) } }`
+     * @property [storageState] - Playwright storage state (path to JSON file or object)
+     *   passed directly to `browser.newContext`.
+     *   If a Scenario is declared with a `cookies` option (e.g. `Scenario('name', { cookies: [...] }, fn)`),
+     *   those cookies are used instead and the configured `storageState` is ignored (no merge).
+     *   May include session cookies, auth tokens, localStorage and (if captured with
+     *   `grabStorageState({ indexedDB: true })`) IndexedDB data; treat as sensitive and do not commit.
      */
-    // @ts-ignore
-    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -2053,6 +2069,8 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
         recordHar?: any;
         testIdAttribute?: string;
+        customLocatorStrategies?: any;
+        storageState?: string | any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -2878,6 +2896,23 @@ declare namespace CodeceptJS {
          * @returns automatically synchronized promise through #recorder
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * Performs click at specific coordinates.
+         * If locator is provided, the coordinates are relative to the element.
+         * If locator is not provided, the coordinates are global page coordinates.
+         *
+         * ```js
+         * // Click at global coordinates (100, 200)
+         * I.clickXY(100, 200);
+         *
+         * // Click at coordinates (50, 30) relative to element
+         * I.clickXY('#someElement', 50, 30);
+         * ```
+         * @param locator - Element to click on or X coordinate if no element.
+         * @param [x] - X coordinate relative to element, or Y coordinate if locator is a number.
+         * @param [y] - Y coordinate relative to element.
+         */
+        clickXY(locator: CodeceptJS.LocatorOrString | number, x?: number, y?: number): Promise<void>;
         /**
          * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
          *
@@ -2983,7 +3018,7 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): void;
         /**
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313](https://github.com/puppeteer/puppeteer/issues/1313)).
          *
          * Presses a key in the browser (on a focused element).
          *
@@ -3175,10 +3210,25 @@ declare namespace CodeceptJS {
          * I.selectOption({css: 'form select[name=account]'}, 'Premium');
          * ```
          *
+         * You can also use ARIA role locators:
+         *
+         * ```js
+         * I.selectOption({ role: 'combobox', name: 'Country' }, 'United States');
+         * I.selectOption({ role: 'listbox', name: 'options' }, 'Option 1');
+         * ```
+         *
+         * Or JSON string locators:
+         *
+         * ```js
+         * I.selectOption('{"role": "combobox", "name": "Country"}', 'United States');
+         * I.selectOption('{"role": "listbox", "name": "options"}', 'Option 1');
+         * ```
+         *
          * Provide an array for the second argument to select multiple options.
          *
          * ```js
          * I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+         * I.selectOption({ role: 'combobox', name: 'OS' }, ['Android', 'iOS']);
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
@@ -3405,6 +3455,27 @@ declare namespace CodeceptJS {
          * @returns attribute value
          */
         grabCookie(name?: string): any;
+        /**
+         * Grab the current storage state (cookies, localStorage, etc.) via Playwright's `browserContext.storageState()`.
+         * Returns the raw object that Playwright provides.
+         *
+         * Security: The returned object can contain authentication tokens, session cookies
+         * and (when `indexedDB: true` is used) data that may include user PII. Treat it as a secret.
+         * Avoid committing it to source control and prefer storing it in a protected secrets store / CI artifact vault.
+         * @param [options.indexedDB] - set to true to include IndexedDB in snapshot (Playwright >=1.51)
+         *
+         * ```js
+         * // basic usage
+         * const state = await I.grabStorageState();
+         * require('fs').writeFileSync('authState.json', JSON.stringify(state));
+         *
+         * // include IndexedDB when using Firebase Auth, etc.
+         * const stateWithIDB = await I.grabStorageState({ indexedDB: true });
+         * ```
+         */
+        grabStorageState(options?: {
+            indexedDB?: boolean;
+        }): void;
         /**
          * Clears a cookie by name,
          * if none provided clears all cookies.
@@ -3874,7 +3945,7 @@ declare namespace CodeceptJS {
         /**
          * Waits for navigation to finish. By default, it takes configured `waitForNavigation` option.
          *
-         * See [Playwright's reference](https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions)
+         * See [Playwright's reference](https://playwright.dev/docs/api/class-page#page-wait-for-navigation)
          */
         waitForNavigation(options: any): void;
         /**
@@ -5545,7 +5616,7 @@ declare namespace CodeceptJS {
      * @property [keepBrowserState = false] - keep browser state between tests when `restart` is set to false.
      * @property [keepCookies = false] - keep cookies between tests when `restart` is set to false.
      * @property [waitForAction = 100] - how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-     * @property [waitForNavigation = load] - when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions). Array values are accepted as well.
+     * @property [waitForNavigation = load] - when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.waitforoptions.md). Array values are accepted as well.
      * @property [pressKeyDelay = 10] - delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
      * @property [getPageTimeout = 30000] - config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
      * @property [waitForTimeout = 1000] - default wait* timeout in ms.
@@ -5553,11 +5624,9 @@ declare namespace CodeceptJS {
      * @property [userAgent] - user-agent string.
      * @property [manualStart = false] - do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
      * @property [browser = chrome] - can be changed to `firefox` when using [puppeteer-firefox](https://codecept.io/helpers/Puppeteer-firefox).
-     * @property [chrome] - pass additional [Puppeteer run options](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions).
+     * @property [chrome] - pass additional [Puppeteer run options](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.launchoptions.md).
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
-    // @ts-ignore
-    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -5571,7 +5640,7 @@ declare namespace CodeceptJS {
         keepBrowserState?: boolean;
         keepCookies?: boolean;
         waitForAction?: number;
-        waitForNavigation?: string;
+        waitForNavigation?: string | string[];
         pressKeyDelay?: number;
         getPageTimeout?: number;
         waitForTimeout?: number;
@@ -5583,7 +5652,7 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
     };
     /**
-     * Uses [Google Chrome's Puppeteer](https://github.com/GoogleChrome/puppeteer) library to run tests inside headless Chrome.
+     * Uses [Google Chrome's Puppeteer](https://github.com/puppeteer/puppeteer) library to run tests inside headless Chrome.
      * Browser control is executed via DevTools Protocol (instead of Selenium).
      * This helper works with a browser out of the box with no additional tools required to install.
      *
@@ -5997,6 +6066,17 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         _locate(): void;
+        /**
+         * Get single element by different locator types, including strict locator
+         * Should be used in custom helpers:
+         *
+         * ```js
+         * const element = await this.helpers['Puppeteer']._locateElement({name: 'password'});
+         * ```
+         *
+         * {{ react }}
+         */
+        _locateElement(): void;
         /**
          * Find a checkbox by providing human-readable text:
          * NOTE: Assumes the checkable element exists
@@ -6033,6 +6113,17 @@ declare namespace CodeceptJS {
          * @returns WebElement of being used Web helper
          */
         grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
+        /**
+         * Grab WebElement for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElement = await I.grabWebElement('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElement(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab
          *
@@ -6272,6 +6363,23 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * Performs click at specific coordinates.
+         * If locator is provided, the coordinates are relative to the element.
+         * If locator is not provided, the coordinates are global page coordinates.
+         *
+         * ```js
+         * // Click at global coordinates (100, 200)
+         * I.clickXY(100, 200);
+         *
+         * // Click at coordinates (50, 30) relative to element
+         * I.clickXY('#someElement', 50, 30);
+         * ```
+         * @param locator - Element to click on or X coordinate if no element.
+         * @param [x] - X coordinate relative to element, or Y coordinate if locator is a number.
+         * @param [y] - Y coordinate relative to element.
+         */
+        clickXY(locator: CodeceptJS.LocatorOrString | number, x?: number, y?: number): Promise<void>;
         /**
          * Selects a checkbox or radio button.
          * Element is located by label or name or CSS or XPath.
@@ -6357,7 +6465,7 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): void;
         /**
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313](https://github.com/puppeteer/puppeteer/issues/1313)).
          *
          * Presses a key in the browser (on a focused element).
          *
@@ -6551,10 +6659,25 @@ declare namespace CodeceptJS {
          * I.selectOption({css: 'form select[name=account]'}, 'Premium');
          * ```
          *
+         * You can also use ARIA role locators:
+         *
+         * ```js
+         * I.selectOption({ role: 'combobox', name: 'Country' }, 'United States');
+         * I.selectOption({ role: 'listbox', name: 'options' }, 'Option 1');
+         * ```
+         *
+         * Or JSON string locators:
+         *
+         * ```js
+         * I.selectOption('{"role": "combobox", "name": "Country"}', 'United States');
+         * I.selectOption('{"role": "listbox", "name": "options"}', 'Option 1');
+         * ```
+         *
          * Provide an array for the second argument to select multiple options.
          *
          * ```js
          * I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+         * I.selectOption({ role: 'combobox', name: 'OS' }, ['Android', 'iOS']);
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
@@ -7283,7 +7406,7 @@ declare namespace CodeceptJS {
         /**
          * Waits for navigation to finish. By default, takes configured `waitForNavigation` option.
          *
-         * See [Puppeteer's reference](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions)
+         * See [Puppeteer's reference](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.page.waitfornavigation.md)
          */
         waitForNavigation(opts: any): void;
         /**
@@ -7492,6 +7615,22 @@ declare namespace CodeceptJS {
          */
         flushWebSocketMessages(): void;
     }
+    /**
+     * Find elements using Puppeteer's native element discovery methods
+     * Note: Unlike Playwright, Puppeteer's Locator API doesn't have .all() method for multiple elements
+     * @param matcher - Puppeteer context to search within
+     * @param locator - Locator specification
+     * @returns Array of ElementHandle objects
+     */
+    function findElements(matcher: any, locator: any | string): Promise<any[]>;
+    /**
+     * Find a single element using Puppeteer's native element discovery methods
+     * Note: Puppeteer Locator API doesn't have .first() method like Playwright
+     * @param matcher - Puppeteer context to search within
+     * @param locator - Locator specification
+     * @returns Single ElementHandle object
+     */
+    function findElement(matcher: any, locator: any | string): Promise<object>;
     /**
      * ## Configuration
      * @property [endpoint] - API base URL
@@ -7504,8 +7643,6 @@ declare namespace CodeceptJS {
      * @property [onResponse] - an async function which can update response object.
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
-    // @ts-ignore
-    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -7631,6 +7768,16 @@ declare namespace CodeceptJS {
          * @returns response
          */
         sendGetRequest(url: any, headers?: any): Promise<any>;
+        /**
+         * Send HEAD request to REST API
+         *
+         * ```js
+         * I.sendHeadRequest('/api/users.json');
+         * ```
+         * @param [headers = {}] - the headers object to be sent. By default, it is sent as an empty object
+         * @returns response
+         */
+        sendHeadRequest(url: any, headers?: any): Promise<any>;
         /**
          * Sends POST request to API.
          *
@@ -7730,8 +7877,6 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [logLevel = silent] - level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: https://webdriver.io/docs/configuration/#loglevel
      */
-    // @ts-ignore
-    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -8207,6 +8352,17 @@ declare namespace CodeceptJS {
          * @returns WebElement of being used Web helper
          */
         grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
+        /**
+         * Grab WebElement for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElement = await I.grabWebElement('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElement(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Set [WebDriver timeouts](https://webdriver.io/docs/timeouts.html) in realtime.
          *
@@ -8336,6 +8492,23 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * Performs click at specific coordinates.
+         * If locator is provided, the coordinates are relative to the element's top-left corner.
+         * If locator is not provided, the coordinates are relative to the body element.
+         *
+         * ```js
+         * // Click at coordinates (100, 200) relative to body
+         * I.clickXY(100, 200);
+         *
+         * // Click at coordinates (50, 30) relative to element's top-left corner
+         * I.clickXY('#someElement', 50, 30);
+         * ```
+         * @param locator - Element to click on or X coordinate if no element.
+         * @param [x] - X coordinate relative to element's top-left, or Y coordinate if locator is a number.
+         * @param [y] - Y coordinate relative to element's top-left.
+         */
+        clickXY(locator: CodeceptJS.LocatorOrString | number, x?: number, y?: number): Promise<void>;
         /**
          * Emulates right click on an element.
          * Unlike normal click instead of sending native event, emulates a click with JavaScript.
@@ -8423,10 +8596,25 @@ declare namespace CodeceptJS {
          * I.selectOption({css: 'form select[name=account]'}, 'Premium');
          * ```
          *
+         * You can also use ARIA role locators:
+         *
+         * ```js
+         * I.selectOption({ role: 'combobox', name: 'Country' }, 'United States');
+         * I.selectOption({ role: 'listbox', name: 'options' }, 'Option 1');
+         * ```
+         *
+         * Or JSON string locators:
+         *
+         * ```js
+         * I.selectOption('{"role": "combobox", "name": "Country"}', 'United States');
+         * I.selectOption('{"role": "listbox", "name": "options"}', 'Option 1');
+         * ```
+         *
          * Provide an array for the second argument to select multiple options.
          *
          * ```js
          * I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+         * I.selectOption({ role: 'combobox', name: 'OS' }, ['Android', 'iOS']);
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
@@ -9731,8 +9919,8 @@ declare namespace CodeceptJS {
          */
         requireModules(requiringModules: string[]): void;
         /**
-         * Initialize CodeceptJS at specific directory.
-         * If async initialization is required, pass callback as second parameter.
+         * Initialize CodeceptJS at specific dir.
+         * Loads config, requires factory methods
          */
         init(dir: string): void;
         /**
@@ -9746,19 +9934,31 @@ declare namespace CodeceptJS {
         /**
          * Executes bootstrap.
          */
-        bootstrap(): void;
+        bootstrap(): Promise<void>;
         /**
          * Executes teardown.
          */
-        teardown(): void;
+        teardown(): Promise<void>;
         /**
          * Loads tests by pattern or by config.tests
          */
         loadTests(pattern?: string): void;
+        /**
+         * Apply sharding to test files based on shard configuration
+         * @param testFiles - Array of test file paths
+         * @param shardConfig - Shard configuration in format "index/total" (e.g., "1/4")
+         * @returns - Filtered array of test files for this shard
+         */
+        _applySharding(testFiles: string[], shardConfig: string): string[];
         /**
          * Run a specific test or all loaded tests.
          */
         run(test?: string): Promise<void>;
+        /**
+         * Returns the version string of CodeceptJS.
+         * @returns The version string.
+         */
+        static version(): string;
     }
     /**
      * Current configuration
@@ -9801,7 +10001,15 @@ declare namespace CodeceptJS {
         };
     }
     /**
-     * Result of the test run
+     * Statistics for a test result.
+     * @property passes - Number of passed tests.
+     * @property failures - Number of failed tests.
+     * @property tests - Total number of tests.
+     * @property pending - Number of pending tests.
+     * @property failedHooks - Number of failed hooks.
+     * @property start - Start time of the test run.
+     * @property end - End time of the test run.
+     * @property duration - Duration of the test run, in milliseconds.
      */
     type Stats = {
         passes: number;
@@ -9814,10 +10022,82 @@ declare namespace CodeceptJS {
         duration: number;
     };
     /**
-     * Create Result of the test run
+     * Result of a test run. Will be emitted for example in "event.all.result" events.
      */
     class Result {
-        constructor();
+        /**
+         * Resets all collected stats, tests, and failure reports.
+         */
+        reset(): void;
+        /**
+         * Sets the start time to the current time.
+         */
+        start(): void;
+        /**
+         * Sets the end time to the current time.
+         */
+        finish(): void;
+        /**
+         * Whether this result contains any failed tests.
+         */
+        readonly hasFailed: boolean;
+        /**
+         * All collected tests.
+         */
+        readonly tests: CodeceptJS.Test[];
+        /**
+         * The failure reports (array of strings per failed test).
+         */
+        readonly failures: string[][];
+        /**
+         * The test statistics.
+         */
+        readonly stats: Stats;
+        /**
+         * The start time of the test run.
+         */
+        readonly startTime: Date;
+        /**
+         * Adds a test to this result.
+         */
+        addTest(test: CodeceptJS.Test): void;
+        /**
+         * Adds failure reports to this result.
+         */
+        addFailures(newFailures: string[][]): void;
+        /**
+         * Whether this result contains any failed tests.
+         */
+        readonly hasFailures: boolean;
+        /**
+         * The duration of the test run, in milliseconds.
+         */
+        readonly duration: number;
+        /**
+         * All failed tests.
+         */
+        failedTests: CodeceptJS.Test[];
+        /**
+         * All passed tests.
+         */
+        readonly passedTests: CodeceptJS.Test[];
+        /**
+         * All skipped tests.
+         */
+        readonly skippedTests: CodeceptJS.Test[];
+        /**
+         * @returns The JSON representation of this result.
+         */
+        simplify(): any;
+        /**
+         * Saves this result to a JSON file.
+         * @param [fileName] - Path to the JSON file, relative to `output_dir`. Defaults to "result.json".
+         */
+        save(fileName?: string): void;
+        /**
+         * Adds stats to this result.
+         */
+        addStats(newStats?: Partial<Stats>): void;
     }
     /**
      * Dependency Injection Container
@@ -9943,7 +10223,7 @@ declare namespace CodeceptJS {
      * - Logs errors and retries the callback until it either succeeds or the maximum number of attempts is reached.
      * - Restores the session state after each attempt, whether successful or not.
      * @example
-     * const { hopeThat } = require('codeceptjs/effects')
+     * const { retryTo } = require('codeceptjs/effects')
      * await retryTo((tries) => {
      *   if (tries < 3) {
      *     I.see('Non-existent element'); // Simulates a failure
@@ -10041,6 +10321,7 @@ declare namespace CodeceptJS {
         isCSS(): boolean;
         isPlaywrightLocator(): boolean;
         isRole(): boolean;
+        getRoleLocator(): RoleLocator | null;
         isNull(): boolean;
         isXPath(): boolean;
         isCustom(): boolean;
@@ -10100,10 +10381,24 @@ declare namespace CodeceptJS {
          * Filters to modify locators
          */
         static filters: ((arg0: CodeceptJS.LocatorOrString, arg1: Locator) => void)[];
+        /**
+         * Get RoleLocator class (lazy loaded)
+         */
+        static getRoleLocatorClass(): typeof RoleLocator;
+        /**
+         * Set RoleLocator class (called from RoleLocator module)
+         */
+        static setRoleLocatorClass(RoleLocatorClass: typeof RoleLocator): void;
         /**
          * Appends new `Locator` filter to an `Locator.filters` array, and returns the new length of the array.
          */
         static addFilter(fn: (...params: any[]) => any): number;
+        /**
+         * Create a role locator
+         * @param locator - The role locator object
+         * @returns The role locator object
+         */
+        static role(locator: any): any;
     }
     namespace output {
         var stepShift: number;
@@ -10227,6 +10522,10 @@ declare namespace CodeceptJS {
          * Get a state of current queue and tasks
          */
         toString(): string;
+        /**
+         * Get current session ID
+         */
+        getCurrentSessionId(): string | null;
     }
     interface RecorderSession {
         running: boolean;
@@ -10340,6 +10639,10 @@ declare namespace CodeceptJS {
     function Feature(title: string, opts?: {
         [key: string]: any;
     }): FeatureConfig;
+    /**
+     * Exclusive test suite - runs only this feature.
+     */
+    const only: CodeceptJS.IFeature;
     /**
      * Pending test suite.
      */