codeceptjs 3.6.0-beta.1.ai-healers → 3.6.0

package/typings/types.d.ts

@@ -1191,9 +1191,9 @@ declare namespace CodeceptJS {
         expectNotEndsWith(actualValue: any, expectedValueToNotEndWith: any, customErrorMsg?: any): void;
         expectJsonSchema(targetData: any, jsonSchema: any, customErrorMsg?: any): void;
         /**
-         * @param ajvOptions - Pass AJV options
+         * @param [ajvOptions] - Pass AJV options
          */
-        expectJsonSchemaUsingAJV(targetData: any, jsonSchema: any, customErrorMsg?: any, ajvOptions: any): void;
+        expectJsonSchemaUsingAJV(targetData: any, jsonSchema: any, customErrorMsg?: any, ajvOptions?: any): void;
         expectHasProperty(targetData: any, propertyName: any, customErrorMsg?: any): void;
         expectHasAProperty(targetData: any, propertyName: any, customErrorMsg?: any): void;
         expectToBeA(targetData: any, type: any, customErrorMsg?: any): void;
@@ -1799,6 +1799,191 @@ declare namespace CodeceptJS {
          */
         seeResponseMatchesJsonSchema(fnOrSchema: any): void;
     }
+    /**
+     * ## Configuration
+     *
+     * This helper should be configured in codecept.conf.(js|ts)
+     * @property [port = 9393] - Mock server port
+     * @property [host = "0.0.0.0"] - Mock server host
+     * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
+     */
+    type MockServerConfig = {
+        port?: number;
+        host?: string;
+        httpsOpts?: any;
+    };
+    /**
+     * MockServer
+     *
+     * The MockServer Helper in CodeceptJS empowers you to mock any server or service via HTTP or HTTPS, making it an excellent tool for simulating REST endpoints and other HTTP-based APIs.
+     *
+     * <!-- configuration -->
+     *
+     * #### Examples
+     *
+     * You can seamlessly integrate MockServer with other helpers like REST or Playwright. Here's a configuration example inside the `codecept.conf.js` file:
+     *
+     * ```javascript
+     * {
+     *   helpers: {
+     *     REST: {...},
+     *     MockServer: {
+     *       // default mock server config
+     *       port: 9393,
+     *       host: '0.0.0.0',
+     *       httpsOpts: {
+     *         key: '',
+     *         cert: '',
+     *       },
+     *     },
+     *   }
+     * }
+     * ```
+     *
+     * #### Adding Interactions
+     *
+     * Interactions add behavior to the mock server. Use the `I.addInteractionToMockServer()` method to include interactions. It takes an interaction object as an argument, containing request and response details.
+     *
+     * ```javascript
+     * I.addInteractionToMockServer({
+     *    request: {
+     *      method: 'GET',
+     *      path: '/api/hello'
+     *    },
+     *    response: {
+     *      status: 200,
+     *      body: {
+     *        'say': 'hello to mock server'
+     *      }
+     *    }
+     * });
+     * ```
+     *
+     * #### Request Matching
+     *
+     * When a real request is sent to the mock server, it matches the received request with the interactions. If a match is found, it returns the specified response; otherwise, a 404 status code is returned.
+     *
+     * - Strong match on HTTP Method, Path, Query Params & JSON body.
+     * - Loose match on Headers.
+     *
+     * ##### Strong Match on Query Params
+     *
+     * You can send different responses based on query parameters:
+     *
+     * ```javascript
+     * I.addInteractionToMockServer({
+     *   request: {
+     *     method: 'GET',
+     *     path: '/api/users',
+     *     queryParams: {
+     *       id: 1
+     *     }
+     *   },
+     *   response: {
+     *     status: 200,
+     *     body: 'user 1'
+     *   }
+     * });
+     *
+     * I.addInteractionToMockServer({
+     *   request: {
+     *     method: 'GET',
+     *     path: '/api/users',
+     *     queryParams: {
+     *       id: 2
+     *     }
+     *   },
+     *   response: {
+     *     status: 200,
+     *     body: 'user 2'
+     *   }
+     * });
+     * ```
+     *
+     * - GET to `/api/users?id=1` will return 'user 1'.
+     * - GET to `/api/users?id=2` will return 'user 2'.
+     * - For all other requests, it returns a 404 status code.
+     *
+     * ##### Loose Match on Body
+     *
+     * When `strict` is set to false, it performs a loose match on query params and response body:
+     *
+     * ```javascript
+     * I.addInteractionToMockServer({
+     *   strict: false,
+     *   request: {
+     *     method: 'POST',
+     *     path: '/api/users',
+     *     body: {
+     *       name: 'john'
+     *     }
+     *   },
+     *   response: {
+     *     status: 200
+     *   }
+     * });
+     * ```
+     *
+     * - POST to `/api/users` with the body containing `name` as 'john' will return a 200 status code.
+     * - POST to `/api/users` without the `name` property in the body will return a 404 status code.
+     *
+     * Happy testing with MockServer in CodeceptJS! 🚀
+     *
+     * ## Methods
+     */
+    class MockServer {
+        /**
+         * Start the mock server
+         * @param [port] - start the mock server with given port
+         * @returns void
+         */
+        startMockServer(port?: number): any;
+        /**
+         * Stop the mock server
+         * @returns void
+         */
+        stopMockServer(): any;
+        /**
+         * An interaction adds behavior to the mock server
+         *
+         *
+         * ```js
+         * I.addInteractionToMockServer({
+         *    request: {
+         *      method: 'GET',
+         *      path: '/api/hello'
+         *    },
+         *    response: {
+         *      status: 200,
+         *      body: {
+         *        'say': 'hello to mock server'
+         *      }
+         *    }
+         * });
+         * ```
+         * ```js
+         * // with query params
+         * I.addInteractionToMockServer({
+         *    request: {
+         *      method: 'GET',
+         *      path: '/api/hello',
+         *      queryParams: {
+         *       id: 2
+         *     }
+         *    },
+         *    response: {
+         *      status: 200,
+         *      body: {
+         *        'say': 'hello to mock server'
+         *      }
+         *    }
+         * });
+         * ```
+         * @param interaction - add behavior to the mock server
+         * @returns void
+         */
+        addInteractionToMockServer(interaction: CodeceptJS.MockInteraction | any): any;
+    }
     /**
      * Nightmare helper wraps [Nightmare](https://github.com/segmentio/nightmare) library to provide
      * fastest headless testing using Electron engine. Unlike Selenium-based drivers this uses
@@ -2883,6 +3068,7 @@ declare namespace CodeceptJS {
      * @property [bypassCSP] - bypass Content Security Policy or CSP
      * @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).
      */
     type PlaywrightConfig = {
         url?: string;
@@ -2920,6 +3106,7 @@ declare namespace CodeceptJS {
         bypassCSP?: boolean;
         highlightElement?: boolean;
         recordHar?: any;
+        testIdAttribute?: string;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -4747,6 +4934,17 @@ declare namespace CodeceptJS {
          * @returns automatically synchronized promise through #recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
+        /**
+         * Waits for the specified cookie in the cookies.
+         *
+         * ```js
+         * I.waitForCookie("token");
+         * ```
+         * @param name - expected cookie name.
+         * @param [sec = 3] - (optional, `3` by default) time in seconds to wait
+         * @returns automatically synchronized promise through #recorder
+         */
+        waitForCookie(name: string, sec?: number): void;
         /**
          * Grab the data from performance timing using Navigation Timing API.
          * The returned data will contain following things in ms:
@@ -4801,7 +4999,7 @@ declare namespace CodeceptJS {
          * ```
          * This method allows intercepting and mocking requests & responses. [Learn more about it](https://playwright.dev/docs/network#handle-requests)
          * @param [url] - URL, regex or pattern for to match URL
-         * @param [handler] - a function to process reques
+         * @param [handler] - a function to process request
          */
         mockRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
         /**
@@ -4813,29 +5011,17 @@ declare namespace CodeceptJS {
          * ```
          * If no handler is passed, all mock requests for the rote are disabled.
          * @param [url] - URL, regex or pattern for to match URL
-         * @param [handler] - a function to process reques
+         * @param [handler] - a function to process request
          */
         stopMockingRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
         /**
-         * Starts recording the network traffics.
-         * This also resets recorded network requests.
+         * Resets all recorded network requests.
          *
          * ```js
-         * I.startRecordingTraffic();
+         * I.flushNetworkTraffics();
          * ```
          */
         startRecordingTraffic(): void;
-        /**
-         * Grab the recording network traffics
-         *
-         * ```js
-         * const traffics = await I.grabRecordedNetworkTraffics();
-         * expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
-         * expect(traffics[0].response.status).to.equal(200);
-         * expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
-         * ```
-         */
-        grabRecordedNetworkTraffics(): Promise<any[]>;
         /**
          * Blocks traffic of a given URL or a list of URLs.
          *
@@ -4872,6 +5058,10 @@ declare namespace CodeceptJS {
         mockTraffic(urls: any, responseString: any, contentType?: any): void;
         /**
          * Resets all recorded network requests.
+         *
+         * ```js
+         * I.flushNetworkTraffics();
+         * ```
          */
         flushNetworkTraffics(): void;
         /**
@@ -4882,6 +5072,30 @@ declare namespace CodeceptJS {
          * ```
          */
         stopRecordingTraffic(): void;
+        /**
+         * Returns full URL of request matching parameter "urlMatch".
+         * @param urlMatch - Expected URL of request in network traffic. Can be a string or a regular expression.
+         *
+         * Examples:
+         *
+         * ```js
+         * I.grabTrafficUrl('https://api.example.com/session');
+         * I.grabTrafficUrl(/session.*start/);
+         * ```
+         */
+        grabTrafficUrl(urlMatch: string | RegExp): Promise<any>;
+        /**
+         * Grab the recording network traffics
+         *
+         * ```js
+         * const traffics = await I.grabRecordedNetworkTraffics();
+         * expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
+         * expect(traffics[0].response.status).to.equal(200);
+         * expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
+         * ```
+         * @returns recorded network traffics
+         */
+        grabRecordedNetworkTraffics(): any[];
         /**
          * Verifies that a certain request is part of network traffic.
          *
@@ -4890,13 +5104,13 @@ declare namespace CodeceptJS {
          * I.amOnPage('https://openai.com/blog/chatgpt');
          * I.startRecordingTraffic();
          * await I.seeTraffic({
-         *    name: 'sentry event',
-         *    url: 'https://images.openai.com/blob/cf717bdb-0c8c-428a-b82b-3c3add87a600',
-         *    parameters: {
-         *       width: '1919',
-         *       height: '1138',
+         *     name: 'sentry event',
+         *     url: 'https://images.openai.com/blob/cf717bdb-0c8c-428a-b82b-3c3add87a600',
+         *     parameters: {
+         *     width: '1919',
+         *     height: '1138',
          *     },
-         * });
+         *   });
          * ```
          *
          * ```js
@@ -4904,12 +5118,12 @@ declare namespace CodeceptJS {
          * I.amOnPage('https://openai.com/blog/chatgpt');
          * I.startRecordingTraffic();
          * await I.seeTraffic({
-         *    name: 'event',
-         *    url: 'https://cloudflareinsights.com/cdn-cgi/rum',
-         *    requestPostData: {
-         *       st: 2,
+         *     name: 'event',
+         *     url: 'https://cloudflareinsights.com/cdn-cgi/rum',
+         *     requestPostData: {
+         *     st: 2,
          *     },
-         * });
+         *   });
          * ```
          * @param opts - options when checking the traffic network.
          * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
@@ -4917,6 +5131,7 @@ declare namespace CodeceptJS {
          * @param [opts.parameters] - Expected parameters of that request in network traffic
          * @param [opts.requestPostData] - Expected that request contains post data in network traffic
          * @param [opts.timeout] - Timeout to wait for request in seconds. Default is 10 seconds.
+         * @returns automatically synchronized promise through #recorder
          */
         seeTraffic(opts: {
             name: string;
@@ -4924,19 +5139,7 @@ declare namespace CodeceptJS {
             parameters?: any;
             requestPostData?: any;
             timeout?: number;
-        }): Promise<any>;
-        /**
-         * Returns full URL of request matching parameter "urlMatch".
-         * @param urlMatch - Expected URL of request in network traffic. Can be a string or a regular expression.
-         *
-         * Examples:
-         *
-         * ```js
-         * I.grabTrafficUrl('https://api.example.com/session');
-         * I.grabTrafficUrl(/session.*start/);
-         * ```
-         */
-        grabTrafficUrl(urlMatch: string | RegExp): Promise<any>;
+        }): void;
         /**
          * Verifies that a certain request is not part of network traffic.
          *
@@ -4949,6 +5152,7 @@ declare namespace CodeceptJS {
          * @param opts - options when checking the traffic network.
          * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
          * @param opts.url - Expected URL of request in network traffic. Can be a string or a regular expression.
+         * @returns automatically synchronized promise through #recorder
          */
         dontSeeTraffic(opts: {
             name: string;
@@ -4961,6 +5165,7 @@ declare namespace CodeceptJS {
          * ```js
          * await I.startRecordingWebSocketMessages();
          * ```
+         * @returns automatically synchronized promise through #recorder
          */
         startRecordingWebSocketMessages(): void;
         /**
@@ -4969,6 +5174,7 @@ declare namespace CodeceptJS {
          * ```js
          * await I.stopRecordingWebSocketMessages();
          * ```
+         * @returns automatically synchronized promise through #recorder
          */
         stopRecordingWebSocketMessages(): void;
         /**
@@ -7612,6 +7818,17 @@ declare namespace CodeceptJS {
          * Returns cookie in JSON format. If name not passed returns all cookies for this domain.
          */
         grabCookie(name?: string): any;
+        /**
+         * Waits for the specified cookie in the cookies.
+         *
+         * ```js
+         * I.waitForCookie("token");
+         * ```
+         * @param name - expected cookie name.
+         * @param [sec = 3] - (optional, `3` by default) time in seconds to wait
+         * @returns automatically synchronized promise through #recorder
+         */
+        waitForCookie(name: string, sec?: number): void;
         /**
          * Clears a cookie by name,
          * if none provided clears all cookies.
@@ -8152,6 +8369,153 @@ declare namespace CodeceptJS {
          * @returns Element bounding rectangle
          */
         grabElementBoundingRect(locator: LocatorOrString, elementSize?: string): Promise<DOMRect> | Promise<number>;
+        /**
+         * Mocks network request using [`Request Interception`](https://pptr.dev/next/guides/request-interception)
+         *
+         * ```js
+         * I.mockRoute(/(\.png$)|(\.jpg$)/, route => route.abort());
+         * ```
+         * This method allows intercepting and mocking requests & responses. [Learn more about it](https://pptr.dev/next/guides/request-interception)
+         * @param [url] - URL, regex or pattern for to match URL
+         * @param [handler] - a function to process request
+         */
+        mockRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
+        /**
+         * Stops network mocking created by `mockRoute`.
+         *
+         * ```js
+         * I.stopMockingRoute(/(\.png$)|(\.jpg$)/);
+         * ```
+         * @param [url] - URL, regex or pattern for to match URL
+         */
+        stopMockingRoute(url?: string | RegExp): void;
+        /**
+         * Resets all recorded network requests.
+         *
+         * ```js
+         * I.flushNetworkTraffics();
+         * ```
+         */
+        flushNetworkTraffics(): void;
+        /**
+         * Stops recording of network traffic. Recorded traffic is not flashed.
+         *
+         * ```js
+         * I.stopRecordingTraffic();
+         * ```
+         */
+        stopRecordingTraffic(): void;
+        /**
+         * Starts recording the network traffics.
+         * This also resets recorded network requests.
+         *
+         * ```js
+         * I.startRecordingTraffic();
+         * ```
+         * @returns automatically synchronized promise through #recorder
+         */
+        startRecordingTraffic(): void;
+        /**
+         * Grab the recording network traffics
+         *
+         * ```js
+         * const traffics = await I.grabRecordedNetworkTraffics();
+         * expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
+         * expect(traffics[0].response.status).to.equal(200);
+         * expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
+         * ```
+         * @returns recorded network traffics
+         */
+        grabRecordedNetworkTraffics(): any[];
+        /**
+         * Verifies that a certain request is part of network traffic.
+         *
+         * ```js
+         * // checking the request url contains certain query strings
+         * I.amOnPage('https://openai.com/blog/chatgpt');
+         * I.startRecordingTraffic();
+         * await I.seeTraffic({
+         *     name: 'sentry event',
+         *     url: 'https://images.openai.com/blob/cf717bdb-0c8c-428a-b82b-3c3add87a600',
+         *     parameters: {
+         *     width: '1919',
+         *     height: '1138',
+         *     },
+         *   });
+         * ```
+         *
+         * ```js
+         * // checking the request url contains certain post data
+         * I.amOnPage('https://openai.com/blog/chatgpt');
+         * I.startRecordingTraffic();
+         * await I.seeTraffic({
+         *     name: 'event',
+         *     url: 'https://cloudflareinsights.com/cdn-cgi/rum',
+         *     requestPostData: {
+         *     st: 2,
+         *     },
+         *   });
+         * ```
+         * @param opts - options when checking the traffic network.
+         * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+         * @param opts.url - Expected URL of request in network traffic
+         * @param [opts.parameters] - Expected parameters of that request in network traffic
+         * @param [opts.requestPostData] - Expected that request contains post data in network traffic
+         * @param [opts.timeout] - Timeout to wait for request in seconds. Default is 10 seconds.
+         * @returns automatically synchronized promise through #recorder
+         */
+        seeTraffic(opts: {
+            name: string;
+            url: string;
+            parameters?: any;
+            requestPostData?: any;
+            timeout?: number;
+        }): void;
+        /**
+         * Verifies that a certain request is not part of network traffic.
+         *
+         * Examples:
+         *
+         * ```js
+         * I.dontSeeTraffic({ name: 'Unexpected API Call', url: 'https://api.example.com' });
+         * I.dontSeeTraffic({ name: 'Unexpected API Call of "user" endpoint', url: /api.example.com.*user/ });
+         * ```
+         * @param opts - options when checking the traffic network.
+         * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+         * @param opts.url - Expected URL of request in network traffic. Can be a string or a regular expression.
+         * @returns automatically synchronized promise through #recorder
+         */
+        dontSeeTraffic(opts: {
+            name: string;
+            url: string | RegExp;
+        }): void;
+        /**
+         * Starts recording of websocket messages.
+         * This also resets recorded websocket messages.
+         *
+         * ```js
+         * await I.startRecordingWebSocketMessages();
+         * ```
+         * @returns automatically synchronized promise through #recorder
+         */
+        startRecordingWebSocketMessages(): void;
+        /**
+         * Stops recording WS messages. Recorded WS messages is not flashed.
+         *
+         * ```js
+         * await I.stopRecordingWebSocketMessages();
+         * ```
+         * @returns automatically synchronized promise through #recorder
+         */
+        stopRecordingWebSocketMessages(): void;
+        /**
+         * Grab the recording WS messages
+         */
+        grabWebSocketMessages(): any[] | undefined;
+        /**
+         * Resets all recorded WS messages.
+         */
+        flushWebSocketMessages(): void;
     }
     /**
      * ## Configuration
@@ -10707,6 +11071,17 @@ declare namespace CodeceptJS {
          * @returns attribute value
          */
         grabCookie(name?: string): any;
+        /**
+         * Waits for the specified cookie in the cookies.
+         *
+         * ```js
+         * I.waitForCookie("token");
+         * ```
+         * @param name - expected cookie name.
+         * @param [sec = 3] - (optional, `3` by default) time in seconds to wait
+         * @returns automatically synchronized promise through #recorder
+         */
+        waitForCookie(name: string, sec?: number): void;
         /**
          * Accepts the active JavaScript native popup window, as created by window.alert|window.confirm|window.prompt.
          * Don't confuse popups with modal windows, as created by [various
@@ -11300,10 +11675,122 @@ declare namespace CodeceptJS {
          * Placeholder for ~ locator only test case write once run on both Appium and WebDriver.
          */
         runInWeb(): void;
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Resets all recorded network requests.
+         *
+         * ```js
+         * I.flushNetworkTraffics();
+         * ```
+         */
+        flushNetworkTraffics(): void;
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Stops recording of network traffic. Recorded traffic is not flashed.
+         *
+         * ```js
+         * I.stopRecordingTraffic();
+         * ```
+         */
+        stopRecordingTraffic(): void;
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Starts recording the network traffics.
+         * This also resets recorded network requests.
+         *
+         * ```js
+         * I.startRecordingTraffic();
+         * ```
+         * @returns automatically synchronized promise through #recorder
+         */
+        startRecordingTraffic(): void;
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Grab the recording network traffics
+         *
+         * ```js
+         * const traffics = await I.grabRecordedNetworkTraffics();
+         * expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
+         * expect(traffics[0].response.status).to.equal(200);
+         * expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
+         * ```
+         * @returns recorded network traffics
+         */
+        grabRecordedNetworkTraffics(): any[];
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Verifies that a certain request is part of network traffic.
+         *
+         * ```js
+         * // checking the request url contains certain query strings
+         * I.amOnPage('https://openai.com/blog/chatgpt');
+         * I.startRecordingTraffic();
+         * await I.seeTraffic({
+         *     name: 'sentry event',
+         *     url: 'https://images.openai.com/blob/cf717bdb-0c8c-428a-b82b-3c3add87a600',
+         *     parameters: {
+         *     width: '1919',
+         *     height: '1138',
+         *     },
+         *   });
+         * ```
+         *
+         * ```js
+         * // checking the request url contains certain post data
+         * I.amOnPage('https://openai.com/blog/chatgpt');
+         * I.startRecordingTraffic();
+         * await I.seeTraffic({
+         *     name: 'event',
+         *     url: 'https://cloudflareinsights.com/cdn-cgi/rum',
+         *     requestPostData: {
+         *     st: 2,
+         *     },
+         *   });
+         * ```
+         * @param opts - options when checking the traffic network.
+         * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+         * @param opts.url - Expected URL of request in network traffic
+         * @param [opts.parameters] - Expected parameters of that request in network traffic
+         * @param [opts.requestPostData] - Expected that request contains post data in network traffic
+         * @param [opts.timeout] - Timeout to wait for request in seconds. Default is 10 seconds.
+         * @returns automatically synchronized promise through #recorder
+         */
+        seeTraffic(opts: {
+            name: string;
+            url: string;
+            parameters?: any;
+            requestPostData?: any;
+            timeout?: number;
+        }): void;
+        /**
+         * _Note:_ Only works when devtoolsProtocol is enabled.
+         *
+         * Verifies that a certain request is not part of network traffic.
+         *
+         * Examples:
+         *
+         * ```js
+         * I.dontSeeTraffic({ name: 'Unexpected API Call', url: 'https://api.example.com' });
+         * I.dontSeeTraffic({ name: 'Unexpected API Call of "user" endpoint', url: /api.example.com.*user/ });
+         * ```
+         * @param opts - options when checking the traffic network.
+         * @param opts.name - A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+         * @param opts.url - Expected URL of request in network traffic. Can be a string or a regular expression.
+         * @returns automatically synchronized promise through #recorder
+         */
+        dontSeeTraffic(opts: {
+            name: string;
+            url: string | RegExp;
+        }): void;
     }
     interface ActorStatic {
         /**
-         * add print comment method`
+         * Print the comment on log. Also, adding a step in the `Test.steps` object
          */
         say(msg: string, color?: string): void;
         /**
@@ -11637,6 +12124,7 @@ declare namespace CodeceptJS {
         isShadow(): boolean;
         isFrame(): boolean;
         isCSS(): boolean;
+        isPlaywrightLocator(): boolean;
         isNull(): boolean;
         isXPath(): boolean;
         isCustom(): boolean;
@@ -11889,14 +12377,14 @@ declare namespace CodeceptJS {
      * Detox provides a grey box testing for mobile applications, playing especially good for React Native apps.
      *
      * Detox plays quite differently from Appium. To establish detox testing you need to build a mobile application in a special way to inject Detox code.
-     * This why **Detox is grey box testing** solution, so you need an access to application source code, and a way to build and execute it on emulator.
+     * This why **Detox is grey box testing** solution, so you need access to application source code, and a way to build and execute it on emulator.
      *
      * Comparing to Appium, Detox runs faster and more stable but requires an additional setup for build.
      *
      * ### Setup
      *
-     * 1. [Install and configure Detox for iOS](https://github.com/wix/Detox/blob/master/docs/Introduction.GettingStarted.md) and [Android](https://github.com/wix/Detox/blob/master/docs/Introduction.Android.md)
-     * 2. [Build an application](https://github.com/wix/Detox/blob/master/docs/Introduction.GettingStarted.md#step-4-build-your-app-and-run-detox-tests) using `detox build` command.
+     * 1. [Install and configure Detox](https://wix.github.io/Detox/docs/introduction/project-setup)
+     * 2. [Build an application](https://wix.github.io/Detox/docs/introduction/project-setup#step-5-build-the-app) using `detox build` command.
      * 3. Install [CodeceptJS](https://codecept.io) and detox-helper:
      *
      * ```
@@ -11909,15 +12397,28 @@ declare namespace CodeceptJS {
      *
      * ```js
      *  "detox": {
-     *    "configurations": {
-     *      "ios.sim.debug": {
-     *        "binaryPath": "ios/build/Build/Products/Debug-iphonesimulator/example.app",
-     *        "build": "xcodebuild -project ios/example.xcodeproj -scheme example -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build",
-     *        "type": "ios.simulator",
-     *        "name": "iPhone 7"
-     *      }
-     *    }
-     *  }
+     *     "configurations": {
+     *       "ios.sim.debug": {
+     *         "device": "simulator",
+     *         "app": "ios.debug"
+     *       }
+     *     },
+     *     "apps": {
+     *       "ios.debug": {
+     *         "type": "ios.app",
+     *         "binaryPath": "../test/ios/build/Build/Products/Debug-iphonesimulator/MyTestApp.app",
+     *         "build": "xcodebuild -workspace ../test/ios/MyTestApp.xcworkspace -scheme MyTestApp -configuration Debug -sdk iphonesimulator -derivedDataPath ../test/ios/build"
+     *       }
+     *     },
+     *     "devices": {
+     *       "simulator": {
+     *         "type": "ios.simulator",
+     *         "device": {
+     *           "type": "iPhone 15"
+     *         }
+     *       }
+     *     }
+     *   }
      * ```
      *
      *
@@ -12012,6 +12513,14 @@ declare namespace CodeceptJS {
          * ```
          */
         setPortraitOrientation(): void;
+        /**
+         * Grab the device platform
+         *
+         * ```js
+         * const platform = await I.grabPlatform();
+         * ```
+         */
+        grabPlatform(): void;
         /**
          * Execute code only on iOS
          *
@@ -12101,6 +12610,19 @@ declare namespace CodeceptJS {
          * ```
          */
         click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
+        /**
+         * Clicks on an element.
+         * Element can be located by its label
+         *
+         * The second parameter is a context (id | type | accessibility id) to narrow the search.
+         *
+         *
+         * ```js
+         * I.tapByLabel('Login'); // locate by text
+         * I.tapByLabel('Login', '#nav'); // locate by text inside #nav
+         * ```
+         */
+        tapByLabel(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Performs click on element with horizontal and vertical offset.
          * An element is located by text, id, accessibility id.
@@ -12151,6 +12673,17 @@ declare namespace CodeceptJS {
          * @param [context = null] - context element
          */
         seeElement(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
+        /**
+         * Checks if an element exists.
+         *
+         * ```js
+         * I.checkIfElementExists('~edit'); // located by accessibility id
+         * I.checkIfElementExists('~edit', '#menu'); // element inside #menu
+         * ```
+         * @param locator - element to locate
+         * @param [context = null] - context element
+         */
+        checkIfElementExists(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Checks that element is not visible.
          * Use second parameter to narrow down the search.
@@ -12200,6 +12733,18 @@ declare namespace CodeceptJS {
          * @param value - value to fill
          */
         fillField(field: CodeceptJS.LocatorOrString, value: string): void;
+        /**
+         * Taps return key.
+         * A field can be located by text, accessibility id, id.
+         *
+         * ```js
+         * I.tapReturnKey('Username');
+         * I.tapReturnKey('~name');
+         * I.tapReturnKey({ android: 'NAME', ios: 'name' });
+         * ```
+         * @param field - an input element to fill in
+         */
+        tapReturnKey(field: CodeceptJS.LocatorOrString): void;
         /**
          * Clears a text field.
          * A field can be located by text, accessibility id, id.
@@ -12325,7 +12870,7 @@ declare namespace CodeceptJS {
          */
         waitForElementVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
-         * Waits an elment to become not visible.
+         * Waits an elmenet to become not visible.
          *
          * ```js
          * I.waitToHide('#message', 2); // wait for 2 seconds
@@ -12334,6 +12879,14 @@ declare namespace CodeceptJS {
          * @param [sec = 5] - number of seconds to wait
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
+        /**
+         * Scrolls within a scrollable container to an element.
+         * @param targetLocator - Locator of the element to scroll to
+         * @param containerLocator - Locator of the scrollable container
+         * @param direction - 'up' or 'down'
+         * @param [offset = 100] - Offset for scroll, can be adjusted based on need
+         */
+        scrollToElement(targetLocator: CodeceptJS.LocatorOrString, containerLocator: CodeceptJS.LocatorOrString, direction?: string, offset?: number): void;
     }
     /**
      * Abstract class.