codeceptjs 3.5.4-beta.1 → 3.5.5

package/typings/types.d.ts

@@ -841,7 +841,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Opposite to `see`. Checks that a text is not present on a page.
          * Use context parameter to narrow down the search.
@@ -1022,7 +1022,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that a page contains a visible text.
          * Use context parameter to narrow down the search.
@@ -1298,6 +1298,21 @@ declare namespace CodeceptJS {
          * @returns Promise<any>
          */
         sendMutation(mutation: string, variables?: any, options?: any, headers?: any): any;
+        /**
+         * Sets request headers for all requests of this test
+         * @param headers - headers list
+         */
+        haveRequestHeaders(headers: any): void;
+        /**
+         * Adds a header for Bearer authentication
+         *
+         * ```js
+         * // we use secret function to hide token from logs
+         * I.amBearerAuthenticated(secret('heregoestoken'))
+         * ```
+         * @param accessToken - Bearer access token
+         */
+        amBearerAuthenticated(accessToken: string | CodeceptJS.Secret): void;
     }
     /**
      * Helper for managing remote data using GraphQL queries.
@@ -2060,12 +2075,14 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          * Wrapper for synchronous [evaluate](https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2)
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -2089,13 +2106,15 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          * Wrapper for asynchronous [evaluate](https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2).
          * Unlike NightmareJS implementation calling `done` will return its first argument.
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Resize the current window to provided width and height.
          * First parameter can be set to `maximize`.
@@ -2195,7 +2214,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -2208,7 +2227,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Sends [input event](http://electron.atom.io/docs/api/web-contents/#webcontentssendinputeventevent) on a page.
          * Can submit special keys like 'Enter', 'Backspace', etc
@@ -2742,7 +2761,7 @@ declare namespace CodeceptJS {
      * @property [keepBrowserState = false] - keep browser state between tests when `restart` is set to 'session'.
      * @property [keepCookies = false] - keep cookies between tests when `restart` is set to 'session'.
      * @property [waitForAction] - how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-     * @property [waitForNavigation] - When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API](https://playwright.dev/docs/api/class-page#page-wait-for-navigation).
+     * @property [waitForNavigation] - When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `commit`. Choose one of those options is possible. See [Playwright API](https://playwright.dev/docs/api/class-page#page-wait-for-url).
      * @property [pressKeyDelay = 10] - Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
      * @property [getPageTimeout] - config option to set maximum navigation time in milliseconds.
      * @property [waitForTimeout] - default wait* timeout in ms. Default: 1000.
@@ -2759,7 +2778,7 @@ declare namespace CodeceptJS {
      * @property [ignoreLog] - An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values](https://playwright.dev/docs/api/class-consolemessage#console-message-type).
      * @property [ignoreHTTPSErrors] - Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
      * @property [bypassCSP] - bypass Content Security Policy or CSP
-     * @property [highlightElement] - highlight the interacting elements
+     * @property [highlightElement] - highlight the interacting elements. Default: false
      */
     type PlaywrightConfig = {
         url?: string;
@@ -2778,7 +2797,7 @@ declare namespace CodeceptJS {
         keepBrowserState?: boolean;
         keepCookies?: boolean;
         waitForAction?: number;
-        waitForNavigation?: 'load' | 'domcontentloaded' | 'networkidle';
+        waitForNavigation?: 'load' | 'domcontentloaded' | 'commit';
         pressKeyDelay?: number;
         getPageTimeout?: number;
         waitForTimeout?: number;
@@ -2907,6 +2926,7 @@ declare namespace CodeceptJS {
      *      url: "http://localhost",
      *      show: true // headless mode not supported for extensions
      *      chromium: {
+     *        // Note: due to this would launch persistent context, so to avoid the error when running tests with run-workers a timestamp would be appended to the defined folder name. For instance: playwright-tmp_1692715649511
      *        userDataDir: '/tmp/playwright-tmp', // necessary to launch the browser in normal mode instead of incognito,
      *        args: [
      *           `--disable-extensions-except=${pathToExtension}`,
@@ -3309,7 +3329,16 @@ declare namespace CodeceptJS {
          */
         _locate(): void;
         /**
-         * Find a checkbox by providing human readable text:
+         * Get the first element by different locator types, including strict locator
+         * Should be used in custom helpers:
+         *
+         * ```js
+         * const element = await this.helpers['Playwright']._locateElement({name: 'password'});
+         * ```
+         */
+        _locateElement(): void;
+        /**
+         * Find a checkbox by providing human-readable text:
          * NOTE: Assumes the checkable element exists
          *
          * ```js
@@ -3318,7 +3347,7 @@ declare namespace CodeceptJS {
          */
         _locateCheckable(): void;
         /**
-         * Find a clickable element by providing human readable text:
+         * Find a clickable element by providing human-readable text:
          *
          * ```js
          * this.helpers['Playwright']._locateClickable('Next page').then // ...
@@ -3326,7 +3355,7 @@ declare namespace CodeceptJS {
          */
         _locateClickable(): void;
         /**
-         * Find field elements by providing human readable text:
+         * Find field elements by providing human-readable text:
          *
          * ```js
          * this.helpers['Playwright']._locateFields('Your email').then // ...
@@ -3811,7 +3840,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -3824,7 +3853,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Attaches a file to element located by label, name, CSS or XPath
          * Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
@@ -4516,11 +4545,18 @@ declare namespace CodeceptJS {
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
-         * Waits for navigation to finish. By default takes configured `waitForNavigation` option.
+         * 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)
          */
         waitForNavigation(options: any): void;
+        /**
+         * Waits for page navigates to a new URL or reloads. By default, it takes configured `waitForNavigation` option.
+         *
+         * See [Playwright's reference](https://playwright.dev/docs/api/class-page#page-wait-for-url)
+         * @param url - A glob pattern, regex pattern or predicate receiving URL to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string.
+         */
+        waitForURL(url: string | RegExp, options: any): void;
         /**
          * Waits for an element to become not attached to the DOM on a page (by default waits for 1sec).
          * Element can be located by CSS or XPath.
@@ -4603,20 +4639,27 @@ declare namespace CodeceptJS {
          */
         stopMockingRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
         /**
-         * Starts recording of network traffic.
+         * Starts recording the network traffics.
          * This also resets recorded network requests.
          *
          * ```js
          * I.startRecordingTraffic();
          * ```
          */
-        startRecordingTraffic(): Promise<void>;
+        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(): any[];
+        grabRecordedNetworkTraffics(): Promise<any[]>;
         /**
-         * Blocks traffic for URL.
+         * Blocks traffic of a given URL or a list of URLs.
          *
          * Examples:
          *
@@ -4626,9 +4669,13 @@ declare namespace CodeceptJS {
          * I.blockTraffic('http://example.com/**');
          * I.blockTraffic(/\.css$/);
          * ```
-         * @param url - URL to block . URL can contain * for wildcards. Example: https://www.example.com** to block all traffic for that domain. Regexp are also supported.
+         *
+         * ```js
+         * I.blockTraffic(['http://example.com/css/style.css', 'http://example.com/css/*.css']);
+         * ```
+         * @param urls - URL or a list of URLs to block . URL can contain * for wildcards. Example: https://www.example.com** to block all traffic for that domain. Regexp are also supported.
          */
-        blockTraffic(url: any): void;
+        blockTraffic(urls: string | any[] | RegExp): void;
         /**
          * Mocks traffic for URL(s).
          * This is a powerful feature to manipulate network traffic. Can be used e.g. to stabilize your tests, speed up your tests or as a last resort to make some test scenarios even possible.
@@ -4729,42 +4776,84 @@ declare namespace CodeceptJS {
             name: string;
             url: string | RegExp;
         }): void;
-    }
-    /**
-     * This helper works the same as MockRequest helper. It has been included for backwards compatibility
-     * reasons. So use MockRequest helper instead of this.
-     *
-     * Please refer to MockRequest helper documentation for details.
-     *
-     * ### Installations
-     *
-     * Requires [Polly.js](https://netflix.github.io/pollyjs/#/) library by Netflix installed
-     *
-     * ```
-     * npm i @pollyjs/core @pollyjs/adapter-puppeteer --save-dev
-     * ```
-     *
-     * Requires Puppeteer helper or WebDriver helper enabled
-     *
-     * ### Configuration
-     *
-     * Just enable helper in config file:
-     *
-     * ```js
-     * helpers: {
-     *    Puppeteer: {
-     *      // regular Puppeteer config here
-     *    },
-     *    Polly: {}
-     * }
-     * ```
-     * The same can be done when using WebDriver helper..
-     *
-     * ### Usage
-     *
-     * Use `I.mockRequest` to intercept and mock requests.
-     */
-    class Polly {
+        /**
+         * Starts recording of websocket messages.
+         * This also resets recorded websocket messages.
+         *
+         * ```js
+         * await I.startRecordingWebSocketMessages();
+         * ```
+         */
+        startRecordingWebSocketMessages(): void;
+        /**
+         * Stops recording WS messages. Recorded WS messages is not flashed.
+         *
+         * ```js
+         * await I.stopRecordingWebSocketMessages();
+         * ```
+         */
+        stopRecordingWebSocketMessages(): void;
+        /**
+         * Grab the recording WS messages
+         */
+        grabWebSocketMessages(): any[];
+        /**
+         * Resets all recorded WS messages.
+         */
+        flushWebSocketMessages(): void;
+        /**
+         * Return a performance metric from the chrome cdp session.
+         * Note: Chrome-only
+         *
+         * Examples:
+         *
+         * ```js
+         * const metrics = await I.grabMetrics();
+         *
+         * // returned metrics
+         *
+         * [
+         *   { name: 'Timestamp', value: 1584904.203473 },
+         *   { name: 'AudioHandlers', value: 0 },
+         *   { name: 'AudioWorkletProcessors', value: 0 },
+         *   { name: 'Documents', value: 22 },
+         *   { name: 'Frames', value: 10 },
+         *   { name: 'JSEventListeners', value: 366 },
+         *   { name: 'LayoutObjects', value: 1240 },
+         *   { name: 'MediaKeySessions', value: 0 },
+         *   { name: 'MediaKeys', value: 0 },
+         *   { name: 'Nodes', value: 4505 },
+         *   { name: 'Resources', value: 141 },
+         *   { name: 'ContextLifecycleStateObservers', value: 34 },
+         *   { name: 'V8PerContextDatas', value: 4 },
+         *   { name: 'WorkerGlobalScopes', value: 0 },
+         *   { name: 'UACSSResources', value: 0 },
+         *   { name: 'RTCPeerConnections', value: 0 },
+         *   { name: 'ResourceFetchers', value: 22 },
+         *   { name: 'AdSubframes', value: 0 },
+         *   { name: 'DetachedScriptStates', value: 2 },
+         *   { name: 'ArrayBufferContents', value: 1 },
+         *   { name: 'LayoutCount', value: 0 },
+         *   { name: 'RecalcStyleCount', value: 0 },
+         *   { name: 'LayoutDuration', value: 0 },
+         *   { name: 'RecalcStyleDuration', value: 0 },
+         *   { name: 'DevToolsCommandDuration', value: 0.000013 },
+         *   { name: 'ScriptDuration', value: 0 },
+         *   { name: 'V8CompileDuration', value: 0 },
+         *   { name: 'TaskDuration', value: 0.000014 },
+         *   { name: 'TaskOtherDuration', value: 0.000001 },
+         *   { name: 'ThreadTime', value: 0.000046 },
+         *   { name: 'ProcessTime', value: 0.616852 },
+         *   { name: 'JSHeapUsedSize', value: 19004908 },
+         *   { name: 'JSHeapTotalSize', value: 26820608 },
+         *   { name: 'FirstMeaningfulPaint', value: 0 },
+         *   { name: 'DomContentLoaded', value: 1584903.690491 },
+         *   { name: 'NavigationStart', value: 1584902.841845 }
+         * ]
+         *
+         * ```
+         */
+        grabMetrics(): Promise<object[]>;
     }
     /**
      * Protractor helper is based on [Protractor library](http://www.protractortest.org) and used for testing web applications.
@@ -5153,7 +5242,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -5166,7 +5255,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Appends text to a input field or textarea.
          * Field is located by name, label, CSS or XPath
@@ -5563,9 +5652,11 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -5589,9 +5680,11 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -6111,7 +6204,7 @@ declare namespace CodeceptJS {
      * @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 [highlightElement] - highlight the interacting elements
+     * @property [highlightElement] - highlight the interacting elements. Default: false
      */
     type PuppeteerConfig = {
         url: string;
@@ -7037,7 +7130,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -7050,7 +7143,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Attaches a file to element located by label, name, CSS or XPath
          * Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
@@ -7361,12 +7454,14 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          * If a function returns a Promise It will wait for it resolution.
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -7390,12 +7485,14 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          * Asynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Retrieves all texts from an element located by CSS or XPath and returns it to test.
          * Resumes test execution, so **should be used inside async with `await`** operator.
@@ -8012,72 +8109,6 @@ declare namespace CodeceptJS {
          */
         sendDeleteRequest(url: any, headers?: any): Promise<any>;
     }
-    /**
-     * SeleniumWebdriver helper is based on the official [Selenium Webdriver JS](https://www.npmjs.com/package/selenium-webdriver)
-     * library. It implements common web api methods (amOnPage, click, see).
-     *
-     * ## Backends
-     *
-     * ### Selenium Installation
-     *
-     * 1. Download [Selenium Server](http://docs.seleniumhq.org/download/)
-     * 2. For Chrome browser install [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/getting-started), for Firefox browser install [GeckoDriver](https://github.com/mozilla/geckodriver).
-     * 3. Launch the server: `java -jar selenium-server-standalone-3.xx.xxx.jar`. To locate Chromedriver binary use `-Dwebdriver.chrome.driver=./chromedriver` option. For Geckodriver use `-Dwebdriver.gecko.driver=`.
-     *
-     *
-     * ### PhantomJS Installation
-     *
-     * PhantomJS is a headless alternative to Selenium Server that implements [the WebDriver protocol](https://code.google.com/p/selenium/wiki/JsonWireProtocol).
-     * It allows you to run Selenium tests on a server without a GUI installed.
-     *
-     * 1. Download [PhantomJS](http://phantomjs.org/download.html)
-     * 2. Run PhantomJS in WebDriver mode: `phantomjs --webdriver=4444`
-     *
-     * ## Configuration
-     *
-     * This helper should be configured in codecept.json or codecept.conf.js
-     *
-     * * `url` - base url of website to be tested
-     * * `browser` - browser in which perform testing
-     * * `driver` - which protractor driver to use (local, direct, session, hosted, sauce, browserstack). By default set to 'hosted' which requires selenium server to be started.
-     * * `restart` - restart browser between tests (default: true).
-     * * `smartWait`: (optional) **enables SmartWait**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000
-     * * `disableScreenshots` (optional, default: false)  - don't save screenshot on failure
-     * * `uniqueScreenshotNames` (optional, default: false)  - option to prevent screenshot override if you have scenarios with the same name in different suites
-     * * `keepBrowserState` (optional, default: false)  - keep browser state between tests when `restart` set to false.
-     * * `keepCookies` (optional, default: false)  - keep cookies between tests when `restart` set to false.*
-     * * `seleniumAddress` - Selenium address to connect (default: http://localhost:4444/wd/hub)
-     * * `waitForTimeout`: (optional) sets default wait time in _ms_ for all `wait*` functions. 1000 by default;
-     * * `scriptTimeout`: (optional) sets default timeout for scripts in `executeAsync`. 1000 by default.
-     * * `windowSize`: (optional) default window size. Set to `maximize` or a dimension in the format `640x480`.
-     * * `manualStart` (optional, default: false) - do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriverIO"]._startBrowser()`
-     * * `capabilities`: {} - list of [Desired Capabilities](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities)
-     *
-     * Example:
-     *
-     * ```json
-     * {
-     *    "helpers": {
-     *      "SeleniumWebdriver" : {
-     *        "url": "http://localhost",
-     *        "browser": "chrome",
-     *        "smartWait": 5000,
-     *        "restart": false
-     *      }
-     *    }
-     * }
-     * ```
-     *
-     * ## Access From Helpers
-     *
-     * Receive a WebDriverIO client from a custom helper by accessing `browser` property:
-     *
-     * ```js
-     * this.helpers['SeleniumWebdriver'].browser
-     * ```
-     */
-    class SeleniumWebdriver {
-    }
     /**
      * Client Functions
      */
@@ -8626,7 +8657,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -8639,7 +8670,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that text is equal to provided one.
          *
@@ -8729,12 +8760,14 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          * If a function returns a Promise It will wait for its resolution.
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Retrieves all texts from an element located by CSS or XPath and returns it to test.
          * Resumes test execution, so **should be used inside async with `await`** operator.
@@ -9086,7 +9119,7 @@ declare namespace CodeceptJS {
      * @property [desiredCapabilities] - Selenium's [desired capabilities](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities).
      * @property [manualStart = false] - do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriver"]._startBrowser()`.
      * @property [timeouts] - [WebDriver timeouts](http://webdriver.io/docs/timeouts.html) defined as hash.
-     * @property [highlightElement] - highlight the interacting elements
+     * @property [highlightElement] - highlight the interacting elements. Default: false
      */
     type WebDriverConfig = {
         url: string;
@@ -9989,7 +10022,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        seeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Checks that value of input field or textarea doesn't equal to given value
          * Opposite to `seeInField`.
@@ -10002,7 +10035,7 @@ declare namespace CodeceptJS {
          * @param value - value to check.
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
+        dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
          * Verifies that the specified checkbox is checked.
          *
@@ -10257,13 +10290,15 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          *
          *
          *
          * Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -10287,9 +10322,11 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * @returns script return value
+         *
          * ⚠️ returns a _promise_ which is synchronized internally by recorder
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
          * Scroll element into viewport.
          *
@@ -11056,7 +11093,7 @@ declare namespace CodeceptJS {
         /**
          * Run a specific test or all loaded tests.
          */
-        run(test?: string): void;
+        run(test?: string): Promise<void>;
     }
     /**
      * Current configuration
@@ -11430,7 +11467,9 @@ declare namespace CodeceptJS {
     /**
      * Pauses test execution and starts interactive shell
      */
-    function pause(): void;
+    function pause(passedObject?: {
+        [key: string]: any;
+    }): void;
     /**
      * Singleton object to record all test steps as promises and run them in chain.
      */
@@ -12059,11 +12098,11 @@ declare namespace CodeceptJS {
         /**
          * Hook executed before each test.
          */
-        protected _before(): void;
+        protected _before(test?: Mocha.Test): void;
         /**
          * Hook executed after each test
          */
-        protected _after(): void;
+        protected _after(test?: Mocha.Test): void;
         /**
          * Hook executed after each passed test
          */