codeceptjs 3.3.0-beta.5 → 3.3.2

package/typings/types.d.ts

@@ -32,7 +32,7 @@ declare namespace CodeceptJS {
      * Install [Rosie](https://github.com/rosiejs/rosie) and [Faker](https://www.npmjs.com/package/faker) libraries.
      *
      * ```sh
-     * npm i rosie faker --save-dev
+     * npm i rosie @faker-js/faker --save-dev
      * ```
      *
      * Create a factory file for a resource.
@@ -42,8 +42,8 @@ declare namespace CodeceptJS {
      * ```js
      * // tests/factories/posts.js
      *
-     * var Factory = require('rosie').Factory;
-     * var faker = require('faker');
+     * const Factory = require('rosie').Factory;
+     * const faker = require('@faker-js/faker');
      *
      * module.exports = new Factory()
      *    // no need to set id, it will be set by REST API
@@ -193,7 +193,7 @@ declare namespace CodeceptJS {
          * @param params - predefined parameters
          * @param options - options for programmatically generate the attributes
          */
-        have(factory: any, params: any, options: any): void;
+        have(factory: any, params: any, options: any): Promise<any>;
         /**
          * Generates bunch of records and saves multiple API requests to store them.
          *
@@ -223,7 +223,7 @@ declare namespace CodeceptJS {
     /**
      * Appium Special Methods for Mobile only
      */
-    class Appium {
+    class Appium extends WebDriver {
         /**
          * Execute code only on iOS
          *
@@ -255,7 +255,7 @@ declare namespace CodeceptJS {
          * });
          * ```
          */
-        runOnIOS(caps: any, fn: any): Promise<any>;
+        runOnIOS(caps: any, fn: any): void;
         /**
          * Execute code only on Android
          *
@@ -287,7 +287,7 @@ declare namespace CodeceptJS {
          * });
          * ```
          */
-        runOnAndroid(caps: any, fn: any): Promise<any>;
+        runOnAndroid(caps: any, fn: any): void;
         /**
          * Check if an app is installed.
          *
@@ -376,9 +376,10 @@ declare namespace CodeceptJS {
          * I.setOrientation('LANDSCAPE')
          * ```
          * @param orientation - LANDSCAPE or PORTRAIT
-         * @returns Appium: support Android and iOS
+         *
+         * Appium: support Android and iOS
          */
-        setOrientation(orientation: 'LANDSCAPE' | 'PORTRAIT'): Promise<any>;
+        setOrientation(orientation: 'LANDSCAPE' | 'PORTRAIT'): void;
         /**
          * Get list of all available contexts
          *
@@ -464,7 +465,7 @@ declare namespace CodeceptJS {
          * I.switchToNative('SOME_OTHER_CONTEXT');
          * ```
          */
-        switchToNative(context: any): Promise<void>;
+        switchToNative(context?: any): Promise<void>;
         /**
          * Start an arbitrary Android activity during a session.
          *
@@ -499,9 +500,10 @@ declare namespace CodeceptJS {
          * I.setSettings({cyberdelia: 'open'});
          * ```
          * @param settings - object
-         * @returns Appium: support Android and iOS
+         *
+         * Appium: support Android and iOS
          */
-        setSettings(settings: any): Promise<any>;
+        setSettings(settings: any): void;
         /**
          * Hide the keyboard.
          *
@@ -738,6 +740,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -753,6 +756,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -779,8 +783,9 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Verifies that the specified checkbox is not checked.
          *
@@ -790,6 +795,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -799,6 +805,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -811,6 +818,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -823,6 +831,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSee(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -841,6 +850,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
@@ -948,7 +958,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param scrollIntoViewOptions - see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Supported only for web testing
          */
@@ -962,6 +972,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -972,6 +983,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -986,6 +998,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -999,6 +1012,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         see(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -1022,7 +1036,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Supported only for web testing
          */
@@ -1037,6 +1051,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -1048,6 +1063,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -1059,6 +1075,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -1073,6 +1090,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
     }
@@ -1210,8 +1228,9 @@ declare namespace CodeceptJS {
         _executeQuery(request: any): void;
         /**
          * Prepares request for axios call
+         * @returns graphQLRequest
          */
-        _prepareGraphQLRequest(operation: any, headers: any): void;
+        _prepareGraphQLRequest(operation: any, headers: any): any;
         /**
          * Send query to GraphQL endpoint over http.
          * Returns a response as a promise.
@@ -1228,8 +1247,9 @@ declare namespace CodeceptJS {
          * ```
          * @param variables - that may go along with the query
          * @param options - are additional query options
+         * @returns Promise<any>
          */
-        sendQuery(query: string, variables: any, options: any, headers: any): void;
+        sendQuery(query: string, variables: any, options: any, headers: any): any;
         /**
          * Send query to GraphQL endpoint over http
          *
@@ -1252,8 +1272,9 @@ declare namespace CodeceptJS {
          * ```
          * @param variables - that may go along with the mutation
          * @param options - are additional query options
+         * @returns Promise<any>
          */
-        sendMutation(mutation: string, variables: any, options: any, headers: any): void;
+        sendMutation(mutation: string, variables: any, options: any, headers: any): any;
     }
     /**
      * Helper for managing remote data using GraphQL queries.
@@ -1288,7 +1309,7 @@ declare namespace CodeceptJS {
      * Install [Rosie](https://github.com/rosiejs/rosie) and [Faker](https://www.npmjs.com/package/faker) libraries.
      *
      * ```sh
-     * npm i rosie faker --save-dev
+     * npm i rosie @faker-js/faker --save-dev
      * ```
      *
      * Create a factory file for a resource.
@@ -1298,8 +1319,8 @@ declare namespace CodeceptJS {
      * ```js
      * // tests/factories/users.js
      *
-     * var Factory = require('rosie').Factory;
-     * var faker = require('faker');
+     * const Factory = require('rosie').Factory;
+     * const faker = require('@faker-js/faker');
      *
      * // Used with a constructor function passed to Factory, so that the final build
      * // object matches the necessary pattern to be sent as the variables object.
@@ -1568,7 +1589,7 @@ declare namespace CodeceptJS {
          * Use it to perform custom checks of response data
          *
          * ```js
-         * I.seeResponseValidByCallback({ data, status, expect } => {
+         * I.seeResponseValidByCallback(({ data, status, expect }) => {
          *   expect(status).to.eql(200);
          *   expect(data).keys.to.include(['user', 'company']);
          * });
@@ -1689,6 +1710,7 @@ declare namespace CodeceptJS {
          * ```
          * @param url - url path or global url.
          * @param headers - list of request headers can be passed
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string, headers: any): void;
         /**
@@ -1698,6 +1720,7 @@ declare namespace CodeceptJS {
          * I.seeInTitle('Home Page');
          * ```
          * @param text - text value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInTitle(text: string): void;
         /**
@@ -1707,6 +1730,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInTitle('Error');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInTitle(text: string): void;
         /**
@@ -1737,11 +1761,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -1754,6 +1780,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -1765,6 +1792,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -1778,6 +1806,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         see(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -1790,6 +1819,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSee(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -1800,6 +1830,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -1809,6 +1840,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -1819,6 +1851,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -1828,6 +1861,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -1837,6 +1871,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -1846,6 +1881,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -1858,6 +1894,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -1869,6 +1906,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -1906,8 +1944,9 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Performs a double-click on an element matched by link|button|label|CSS or XPath.
          * Context can be specified as second parameter to narrow search.
@@ -1920,6 +1959,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         doubleClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -1935,6 +1975,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -1948,6 +1989,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -1975,9 +2017,12 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns Wrapper for synchronous [evaluate](https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2)
+         * [!] 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[]): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -2001,15 +2046,19 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns Wrapper for asynchronous [evaluate](https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2).
+         * [!] 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[]): Promise<any>;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Resize the current window to provided width and height.
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -2025,6 +2074,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -2040,6 +2090,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -2058,6 +2109,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
@@ -2069,6 +2121,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -2080,6 +2133,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -2094,6 +2148,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -2106,6 +2161,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -2133,6 +2189,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -2144,6 +2201,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -2157,6 +2215,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Doesn't work if the Chromium DevTools panel is open (as Chromium allows only one attachment to the debugger at a time. [See more](https://github.com/rosshinkley/nightmare-upload#important-note-about-setting-file-upload-inputs))
          */
@@ -2289,6 +2348,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -2306,7 +2366,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Wrapper for `.cookies.set(cookie)`.
          * [See more](https://github.com/segmentio/nightmare/blob/master/Readme.md#cookiessetcookie)
@@ -2319,6 +2379,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -2328,6 +2389,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -2357,6 +2419,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -2375,6 +2438,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -2384,6 +2448,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -2398,6 +2463,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -2409,6 +2475,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -2420,6 +2487,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -2431,6 +2499,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -2443,6 +2512,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -2454,6 +2524,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -2462,6 +2533,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -2477,6 +2549,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -2513,6 +2586,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -2526,6 +2600,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -2534,6 +2609,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -2542,6 +2618,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -2583,15 +2660,19 @@ declare namespace CodeceptJS {
      * * `url`: base url of website to be tested
      * * `browser`: a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
      * * `show`: (optional, default: false) - show browser window.
-     * * `restart`: (optional, default: true) - restart browser between tests.
+     * * `restart`: (optional, default: false) - restart strategy between tests. Possible values:
+     *   * 'context' or **false** - restarts [browser context](https://playwright.dev/docs/api/class-browsercontext) but keeps running browser. Recommended by Playwright team to keep tests isolated.
+     *   * 'browser' or **true** - closes browser and opens it again between tests.
+     *   * 'session' or 'keep' - keeps browser context and session, but cleans up cookies and localStorage between tests. The fastest option when running tests in windowed mode. Works with `keepCookies` and `keepBrowserState` options. This behavior was default before CodeceptJS 3.1
+     * * `timeout`: (optional, default: 1000) -  [timeout](https://playwright.dev/docs/api/class-page#page-set-default-timeout) in ms of all Playwright actions .
      * * `disableScreenshots`: (optional, default: false)  - don't save screenshot on failure.
      * * `emulate`: (optional, default: {}) launch browser in device emulation mode.
      * * `video`: (optional, default: false) enables video recording for failed tests; videos are saved into `output/videos` folder
      * * `trace`: (optional, default: false) record [tracing information](https://playwright.dev/docs/trace-viewer) with screenshots and snapshots.
      * * `fullPageScreenshots` (optional, default: false) - make full page screenshots 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` is set to false.
-     * * `keepCookies`: (optional, default: false) - keep cookies between tests when `restart` is set to false.
+     * * `keepBrowserState`: (optional, default: false) - keep browser state between tests when `restart` is set to 'session'.
+     * * `keepCookies`: (optional, default: false) - keep cookies between tests when `restart` is set to 'session'.
      * * `waitForAction`: (optional) how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
      * * `waitForNavigation`: (optional, default: 'load'). When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API](https://github.com/microsoft/playwright/blob/main/docs/api.md#pagewaitfornavigationoptions).
      * * `pressKeyDelay`: (optional, default: '10'). Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
@@ -2599,6 +2680,7 @@ declare namespace CodeceptJS {
      * * `waitForTimeout`: (optional) default wait* timeout in ms. Default: 1000.
      * * `basicAuth`: (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
      * * `windowSize`: (optional) default window size. Set a dimension like `640x480`.
+     * * `colorScheme`: (optional) default color scheme. Possible values: `dark` | `light` | `no-preference`.
      * * `userAgent`: (optional) user-agent string.
      * * `locale`: (optional) locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
      * * `manualStart`: (optional, default: false) - do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
@@ -2719,7 +2801,7 @@ declare namespace CodeceptJS {
      * }
      * ```
      *
-     * #### Example #7: Launch test with a specifc user locale
+     * #### Example #7: Launch test with a specific user locale
      *
      * ```js
      * {
@@ -2732,6 +2814,19 @@ declare namespace CodeceptJS {
      * }
      * ```
      *
+     * * #### Example #8: Launch test with a specific color scheme
+     *
+     * ```js
+     * {
+     *  helpers: {
+     *   Playwright : {
+     *     url: "http://localhost",
+     *     colorScheme: "dark",
+     *   }
+     *  }
+     * }
+     * ```
+     *
      * Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
      *
      * ## Access From Helpers
@@ -2767,7 +2862,7 @@ declare namespace CodeceptJS {
          * });
          * ```
          * @param description - used to show in logs.
-         * @param fn - async function that executed with Playwright helper as argument
+         * @param fn - async function that executed with Playwright helper as argumen
          */
         usePlaywrightTo(description: string, fn: (...params: any[]) => any): void;
         /**
@@ -2810,6 +2905,7 @@ declare namespace CodeceptJS {
          * I.seeInPopup('Popup text');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInPopup(text: string): void;
         /**
@@ -2843,6 +2939,7 @@ declare namespace CodeceptJS {
          * I.amOnPage('/login'); // opens a login page
          * ```
          * @param url - url path or global url.
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string): void;
         /**
@@ -2850,6 +2947,7 @@ declare namespace CodeceptJS {
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Unlike other drivers Playwright changes the size of a viewport, not the window!
          * Playwright does not control the window of a browser so it can't adjust its real size.
@@ -2886,6 +2984,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -2896,14 +2995,24 @@ declare namespace CodeceptJS {
          * ```
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
+         * @param [options] - [Additional options](https://playwright.dev/docs/api/class-page#page-drag-and-drop) can be passed as 3rd argument.
+         *
+         * ```js
+         * // specify coordinates for source position
+         * I.dragAndDrop('img.src', 'img.dst', { sourcePosition: {x: 10, y: 10} })
+         * ```
+         *
+         * > By default option `force: true` is set
          */
-        dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString): void;
+        dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString, options?: any): void;
         /**
          * Reload the current page.
          *
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -2912,6 +3021,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -2920,6 +3030,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -2933,6 +3044,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -2942,6 +3054,7 @@ declare namespace CodeceptJS {
          * I.seeInTitle('Home Page');
          * ```
          * @param text - text value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInTitle(text: string): void;
         /**
@@ -2957,10 +3070,11 @@ declare namespace CodeceptJS {
         /**
          * Checks that title is equal to provided one.
          *
-         *  ```js
-         *  I.seeTitleEquals('Test title.');
-         *  ```
+         * ```js
+         * I.seeTitleEquals('Test title.');
+         * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTitleEquals(text: string): void;
         /**
@@ -2970,6 +3084,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInTitle('Error');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInTitle(text: string): void;
         /**
@@ -3083,6 +3198,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -3092,6 +3208,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -3102,6 +3219,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -3111,6 +3229,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -3128,7 +3247,7 @@ declare namespace CodeceptJS {
          * ```
          * @param [fileName = downloads] - set filename for downloaded file
          */
-        handleDownloads(fileName?: string): void;
+        handleDownloads(fileName?: string): Promise<void>;
         /**
          * Perform a click on a link or a button, given by a locator.
          * If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
@@ -3153,8 +3272,20 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
+         * @param [opts] - [Additional options](https://playwright.dev/docs/api/class-page#page-click) for click available as 3rd argument.
+         *
+         * Examples:
+         *
+         * ```js
+         * // click on element at position
+         * I.click('canvas', '.model', { position: { x: 20, y: 40 } })
+         *
+         * // make ctrl-click
+         * I.click('.edit', null, { modifiers: ['Ctrl'] } )
+         * ```
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null, opts?: any): void;
         /**
          * Clicks link and waits for navigation (deprecated)
          */
@@ -3186,6 +3317,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         forceClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3200,6 +3332,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         doubleClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3215,6 +3348,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3230,6 +3364,17 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
+         *
+         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
+         *
+         * Examples:
+         *
+         * ```js
+         * // click on element at position
+         * I.checkOption('Agree', '.signup', { position: { x: 5, y: 5 } })
+         * ```
+         * > ⚠️ To avoid flakiness, option `force: true` is set by default
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3245,6 +3390,17 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
+         *
+         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck) for uncheck available as 3rd argument.
+         *
+         * Examples:
+         *
+         * ```js
+         * // click on element at position
+         * I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
+         * ```
+         * > ⚠️ To avoid flakiness, option `force: true` is set by default
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3256,6 +3412,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -3267,6 +3424,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -3280,6 +3438,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to press down.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyDown(key: string): void;
         /**
@@ -3293,6 +3452,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to release.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyUp(key: string): void;
         /**
@@ -3354,6 +3514,7 @@ declare namespace CodeceptJS {
          * - `'Space'`
          * - `'Tab'`
          * @param key - key or array of keys to press.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
@@ -3376,6 +3537,7 @@ declare namespace CodeceptJS {
          * ```
          * @param key - or array of keys to type.
          * @param [delay = null] - (optional) delay in ms between key presses
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         type(key: string | string[], delay?: number): void;
         /**
@@ -3394,6 +3556,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
@@ -3405,6 +3568,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -3416,6 +3580,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -3430,6 +3595,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -3442,6 +3608,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -3455,6 +3622,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
         /**
@@ -3478,6 +3646,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -3498,11 +3667,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -3515,6 +3686,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -3526,6 +3698,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -3539,6 +3712,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         see(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3549,6 +3723,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - element value to check.
          * @param [context = null] - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTextEquals(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3561,6 +3736,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSee(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3600,6 +3776,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -3609,6 +3786,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -3621,6 +3799,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -3632,6 +3811,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -3649,6 +3829,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         setCookie(cookie: Cookie | Cookie[]): void;
         /**
@@ -3658,6 +3839,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -3667,6 +3849,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -3694,6 +3877,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -3718,7 +3902,7 @@ declare namespace CodeceptJS {
          * @param fn - function to be executed in browser context.
          * @param [arg] - optional argument to pass to the function
          */
-        executeScript(fn: string | ((...params: any[]) => any), arg?: any): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), arg?: any): void;
         /**
          * Grab Locator if called within Context
          */
@@ -3825,6 +4009,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param cssProperties - object with CSS properties and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCssPropertiesOnElements(locator: CodeceptJS.LocatorOrString, cssProperties: any): void;
         /**
@@ -3835,6 +4020,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param attributes - attributes and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeAttributesOnElements(locator: CodeceptJS.LocatorOrString, attributes: any): void;
         /**
@@ -3847,6 +4033,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by label|name|CSS|XPath|strict locator.
          * @param offsetX - position to drag.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dragSlider(locator: CodeceptJS.LocatorOrString, offsetX: number): void;
         /**
@@ -3883,6 +4070,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -3896,6 +4084,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -3922,6 +4111,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -3929,6 +4119,7 @@ declare namespace CodeceptJS {
          * Element can be located by CSS or XPath.
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional) time in seconds to wait, 1 by default.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForEnabled(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -3940,6 +4131,7 @@ declare namespace CodeceptJS {
          * @param field - input field.
          * @param value - expected value.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForValue(field: LocatorOrString, value: string, sec?: number): void;
         /**
@@ -3951,6 +4143,7 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number, sec?: number): void;
         /**
@@ -3963,6 +4156,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForClickable(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -3975,6 +4169,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -3986,7 +4181,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * This method accepts [React selectors](https://codecept.io/react).
          */
@@ -4000,6 +4195,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -4011,6 +4207,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -4021,6 +4218,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitInUrl(urlPart: string, sec?: number): void;
         /**
@@ -4032,6 +4230,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitUrlEquals(urlPart: string, sec?: number): void;
         /**
@@ -4046,6 +4245,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4076,6 +4276,7 @@ declare namespace CodeceptJS {
          * I.switchTo(); // switch back to main page
          * ```
          * @param [locator = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchTo(locator?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4094,6 +4295,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -4111,6 +4313,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -4133,8 +4336,9 @@ declare namespace CodeceptJS {
          *   loadEventEnd: 241
          * }
          * ```
+         * @returns automatically synchronized promise through #recorder
          */
-        grabDataFromPerformanceTiming(): void;
+        grabDataFromPerformanceTiming(): Promise<any>;
         /**
          * Grab the width, height, location of given locator.
          * Provide `width` or `height`as second param to get your desired prop.
@@ -4166,9 +4370,9 @@ 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 request
+         * @param [handler] - a function to process reques
          */
-        mockRoute(url?: string, handler?: (...params: any[]) => any): void;
+        mockRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
         /**
          * Stops network mocking created by `mockRoute`.
          *
@@ -4178,9 +4382,9 @@ 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 request
+         * @param [handler] - a function to process reques
          */
-        stopMockingRoute(url?: string, handler?: (...params: any[]) => any): void;
+        stopMockingRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
     }
     /**
      * This helper works the same as MockRequest helper. It has been included for backwards compatibility
@@ -4383,6 +4587,7 @@ declare namespace CodeceptJS {
          * I.amOnPage('/login'); // opens a login page
          * ```
          * @param url - url path or global url.
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string): void;
         /**
@@ -4409,8 +4614,9 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Performs a double-click on an element matched by link|button|label|CSS or XPath.
          * Context can be specified as second parameter to narrow search.
@@ -4423,6 +4629,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         doubleClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4438,6 +4645,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4451,6 +4659,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -4464,6 +4673,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         see(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4474,6 +4684,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - element value to check.
          * @param [context = null] - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTextEquals(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4486,6 +4697,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSee(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4531,6 +4743,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -4549,6 +4762,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
@@ -4562,6 +4776,7 @@ declare namespace CodeceptJS {
          * I.pressKey(['Control','a']);
          * ```
          * @param key - key or array of keys to press.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ keys }}
          */
         pressKey(key: string | string[]): void;
@@ -4576,6 +4791,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
         /**
@@ -4590,6 +4806,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -4602,6 +4819,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -4613,6 +4831,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -4624,6 +4843,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -4639,6 +4859,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4654,6 +4875,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -4665,6 +4887,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -4676,6 +4899,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -4804,15 +5028,17 @@ declare namespace CodeceptJS {
          * I.seeInTitle('Home Page');
          * ```
          * @param text - text value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInTitle(text: string): void;
         /**
          * Checks that title is equal to provided one.
          *
-         *  ```js
-         *  I.seeTitleEquals('Test title.');
-         *  ```
+         * ```js
+         * I.seeTitleEquals('Test title.');
+         * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTitleEquals(text: string): void;
         /**
@@ -4822,6 +5048,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInTitle('Error');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInTitle(text: string): void;
         /**
@@ -4842,6 +5069,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -4851,6 +5079,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -4861,6 +5090,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -4870,6 +5100,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -4879,6 +5110,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -4898,6 +5130,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -4910,6 +5143,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -4921,6 +5155,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -4942,6 +5177,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param cssProperties - object with CSS properties and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCssPropertiesOnElements(locator: CodeceptJS.LocatorOrString, cssProperties: any): void;
         /**
@@ -4952,6 +5188,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param attributes - attributes and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeAttributesOnElements(locator: CodeceptJS.LocatorOrString, attributes: any): void;
         /**
@@ -4979,8 +5216,9 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -5004,8 +5242,9 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -5013,11 +5252,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -5030,6 +5271,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -5041,6 +5283,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -5052,6 +5295,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -5065,6 +5309,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -5076,6 +5321,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -5085,6 +5331,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -5094,6 +5341,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -5130,6 +5378,7 @@ declare namespace CodeceptJS {
          * I.seeInPopup('Popup text');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInPopup(text: string): void;
         /**
@@ -5145,6 +5394,7 @@ declare namespace CodeceptJS {
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -5155,6 +5405,7 @@ declare namespace CodeceptJS {
          * ```
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString): void;
         /**
@@ -5222,6 +5473,7 @@ declare namespace CodeceptJS {
          * I.switchTo(); // switch back to main page
          * ```
          * @param [locator = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchTo(locator?: CodeceptJS.LocatorOrString): void;
         /**
@@ -5231,6 +5483,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -5243,6 +5496,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5254,6 +5508,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5273,6 +5528,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5284,6 +5540,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5295,6 +5552,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5306,6 +5564,7 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number, sec?: number): void;
         /**
@@ -5313,6 +5572,7 @@ declare namespace CodeceptJS {
          * Element can be located by CSS or XPath.
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional) time in seconds to wait, 1 by default.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForEnabled(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -5324,6 +5584,7 @@ declare namespace CodeceptJS {
          * @param field - input field.
          * @param value - expected value.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForValue(field: LocatorOrString, value: string, sec?: number): void;
         /**
@@ -5342,6 +5603,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -5352,6 +5614,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitInUrl(urlPart: string, sec?: number): void;
         /**
@@ -5363,6 +5626,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitUrlEquals(urlPart: string, sec?: number): void;
         /**
@@ -5377,6 +5641,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -5389,6 +5654,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -5406,6 +5672,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -5414,6 +5681,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -5422,6 +5690,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -5468,6 +5737,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         setCookie(cookie: Cookie | Cookie[]): void;
     }
@@ -5677,6 +5947,7 @@ declare namespace CodeceptJS {
          * I.seeInPopup('Popup text');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInPopup(text: string): void;
         /**
@@ -5710,6 +5981,7 @@ declare namespace CodeceptJS {
          * I.amOnPage('/login'); // opens a login page
          * ```
          * @param url - url path or global url.
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string): void;
         /**
@@ -5717,6 +5989,7 @@ declare namespace CodeceptJS {
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * Unlike other drivers Puppeteer changes the size of a viewport, not the window!
          * Puppeteer does not control the window of a browser so it can't adjust its real size.
@@ -5745,7 +6018,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
@@ -5757,6 +6030,7 @@ declare namespace CodeceptJS {
          * ```
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString): void;
         /**
@@ -5765,6 +6039,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -5773,6 +6048,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -5781,6 +6057,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -5794,6 +6071,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -5803,6 +6081,7 @@ declare namespace CodeceptJS {
          * I.seeInTitle('Home Page');
          * ```
          * @param text - text value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInTitle(text: string): void;
         /**
@@ -5818,10 +6097,11 @@ declare namespace CodeceptJS {
         /**
          * Checks that title is equal to provided one.
          *
-         *  ```js
-         *  I.seeTitleEquals('Test title.');
-         *  ```
+         * ```js
+         * I.seeTitleEquals('Test title.');
+         * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTitleEquals(text: string): void;
         /**
@@ -5831,6 +6111,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInTitle('Error');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInTitle(text: string): void;
         /**
@@ -5939,6 +6220,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
@@ -5949,6 +6231,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
@@ -5960,6 +6243,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -5969,6 +6253,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -5995,11 +6280,12 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * {{ react }}
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Perform an emulated click on a link or a button, given by a locator.
          * Unlike normal click instead of sending native event, emulates a click with JavaScript.
@@ -6027,6 +6313,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * {{ react }}
@@ -6040,6 +6327,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6079,7 +6367,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6097,7 +6385,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6115,6 +6403,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -6130,6 +6419,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -6141,6 +6431,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -6152,6 +6443,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -6165,6 +6457,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to press down.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyDown(key: string): void;
         /**
@@ -6178,6 +6471,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to release.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyUp(key: string): void;
         /**
@@ -6239,6 +6533,7 @@ declare namespace CodeceptJS {
          * - `'Space'`
          * - `'Tab'`
          * @param key - key or array of keys to press.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
@@ -6261,6 +6556,7 @@ declare namespace CodeceptJS {
          * ```
          * @param key - or array of keys to type.
          * @param [delay = null] - (optional) delay in ms between key presses
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         type(key: string | string[], delay?: number): void;
         /**
@@ -6279,7 +6575,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
@@ -6292,6 +6588,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -6303,6 +6600,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6319,6 +6617,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -6331,6 +6630,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -6344,6 +6644,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * > ⚠ There is an [issue with file upload in Puppeteer 2.1.0 & 2.1.1](https://github.com/puppeteer/puppeteer/issues/5420), downgrade to 2.0.0 if you face it.
          */
@@ -6369,6 +6670,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -6390,11 +6692,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -6407,6 +6711,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -6418,6 +6723,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -6431,6 +6737,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6443,6 +6750,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - element value to check.
          * @param [context = null] - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTextEquals(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -6455,7 +6763,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6497,6 +6805,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -6506,6 +6815,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -6518,7 +6828,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6532,7 +6842,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -6552,6 +6862,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         setCookie(cookie: Cookie | Cookie[]): void;
         /**
@@ -6561,6 +6872,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -6570,6 +6882,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -6597,6 +6910,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -6624,9 +6938,12 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns If a function returns a Promise It will wait for it resolution.
+         * [!] 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[]): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -6650,9 +6967,12 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns Asynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
+         * [!] 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[]): Promise<any>;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * 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.
@@ -6763,6 +7083,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param cssProperties - object with CSS properties and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeCssPropertiesOnElements(locator: CodeceptJS.LocatorOrString, cssProperties: any): void;
@@ -6774,6 +7095,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param attributes - attributes and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeAttributesOnElements(locator: CodeceptJS.LocatorOrString, attributes: any): void;
@@ -6787,6 +7109,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by label|name|CSS|XPath|strict locator.
          * @param offsetX - position to drag.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         dragSlider(locator: CodeceptJS.LocatorOrString, offsetX: number): void;
@@ -6828,6 +7151,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -6841,6 +7165,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -6850,6 +7175,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -6857,6 +7183,7 @@ declare namespace CodeceptJS {
          * Element can be located by CSS or XPath.
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional) time in seconds to wait, 1 by default.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForEnabled(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -6868,6 +7195,7 @@ declare namespace CodeceptJS {
          * @param field - input field.
          * @param value - expected value.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForValue(field: LocatorOrString, value: string, sec?: number): void;
         /**
@@ -6879,6 +7207,7 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         waitNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number, sec?: number): void;
@@ -6892,6 +7221,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForClickable(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -6904,6 +7234,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
@@ -6916,7 +7247,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * This method accepts [React selectors](https://codecept.io/react).
          */
@@ -6930,6 +7261,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -6941,6 +7273,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -6951,6 +7284,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitInUrl(urlPart: string, sec?: number): void;
         /**
@@ -6962,6 +7296,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitUrlEquals(urlPart: string, sec?: number): void;
         /**
@@ -6976,6 +7311,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7006,6 +7342,7 @@ declare namespace CodeceptJS {
          * I.switchTo(); // switch back to main page
          * ```
          * @param [locator = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchTo(locator?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7024,6 +7361,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -7041,6 +7379,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -7063,8 +7402,9 @@ declare namespace CodeceptJS {
          *   loadEventEnd: 241
          * }
          * ```
+         * @returns automatically synchronized promise through #recorder
          */
-        grabDataFromPerformanceTiming(): void;
+        grabDataFromPerformanceTiming(): Promise<any>;
         /**
          * Grab the width, height, location of given locator.
          * Provide `width` or `height`as second param to get your desired prop.
@@ -7143,7 +7483,7 @@ declare namespace CodeceptJS {
          * ```
          * @param accessToken - Bearer access token
          */
-        amBearerAuthenticated(accessToken: string): void;
+        amBearerAuthenticated(accessToken: string | CodeceptJS.Secret): void;
         /**
          * Executes axios request
          * @returns response
@@ -7402,6 +7742,7 @@ declare namespace CodeceptJS {
          * I.amOnPage('/login'); // opens a login page
          * ```
          * @param url - url path or global url.
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string): void;
         /**
@@ -7409,6 +7750,7 @@ declare namespace CodeceptJS {
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -7435,14 +7777,16 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Reload the current page.
          *
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -7454,6 +7798,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -7472,6 +7817,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         fillField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
@@ -7483,6 +7829,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -7494,6 +7841,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -7507,6 +7855,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
         /**
@@ -7520,6 +7869,7 @@ declare namespace CodeceptJS {
          * I.pressKey(['Control','a']);
          * ```
          * @param key - key or array of keys to press.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ keys }}
          */
@@ -7535,6 +7885,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -7549,6 +7900,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         doubleClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7564,6 +7916,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7579,6 +7932,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7594,6 +7948,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7605,6 +7960,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -7616,6 +7972,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -7639,6 +7996,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -7648,11 +8006,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -7665,6 +8025,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -7676,6 +8037,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -7689,6 +8051,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         see(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7701,6 +8064,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSee(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -7711,6 +8075,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -7720,6 +8085,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -7730,6 +8096,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -7739,6 +8106,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -7750,6 +8118,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number): void;
         /**
@@ -7775,6 +8144,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -7787,6 +8157,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -7804,6 +8175,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -7813,6 +8185,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -7824,6 +8197,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -7837,6 +8211,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -7846,6 +8221,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -7873,9 +8249,12 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns If a function returns a Promise It will wait for it resolution.
+         * [!] 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[]): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * 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.
@@ -7994,6 +8373,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -8002,6 +8382,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -8015,6 +8396,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -8025,6 +8407,7 @@ declare namespace CodeceptJS {
          * I.switchTo(); // switch back to main page
          * ```
          * @param [locator = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchTo(locator?: CodeceptJS.LocatorOrString): void;
         /**
@@ -8042,6 +8425,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         setCookie(cookie: Cookie | Cookie[]): void;
         /**
@@ -8051,6 +8435,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -8060,6 +8445,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -8087,6 +8473,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -8097,6 +8484,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitInUrl(urlPart: string, sec?: number): void;
         /**
@@ -8108,6 +8496,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitUrlEquals(urlPart: string, sec?: number): void;
         /**
@@ -8126,6 +8515,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -8137,6 +8527,7 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number, sec?: number): void;
         /**
@@ -8149,6 +8540,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -8160,6 +8552,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -8171,6 +8564,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -8185,6 +8579,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
     }
@@ -8622,6 +9017,7 @@ declare namespace CodeceptJS {
          * I.amOnPage('/login'); // opens a login page
          * ```
          * @param url - url path or global url.
+         * @returns automatically synchronized promise with recorder #!
          */
         amOnPage(url: string): void;
         /**
@@ -8648,11 +9044,12 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * {{ react }}
          */
-        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Perform an emulated click on a link or a button, given by a locator.
          * Unlike normal click instead of sending native event, emulates a click with JavaScript.
@@ -8680,6 +9077,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * {{ react }}
@@ -8697,7 +9095,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -8715,7 +9113,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -8737,7 +9135,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - clickable link or button located by text, or any element located by CSS|XPath|strict locator.
          * @param [context = null] - (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -8758,7 +9156,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - text value to fill.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          * {{ custom }}
          */
@@ -8772,6 +9170,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator
          * @param value - text value to append.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         appendField(field: CodeceptJS.LocatorOrString, value: string): void;
@@ -8784,6 +9183,7 @@ declare namespace CodeceptJS {
          * I.clearField('#email');
          * ```
          * @param editable - field located by label|name|CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearField(editable: LocatorOrString): void;
         /**
@@ -8807,6 +9207,7 @@ declare namespace CodeceptJS {
          * ```
          * @param select - field located by label|name|CSS|XPath|strict locator.
          * @param option - visible text or value of option.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
@@ -8820,6 +9221,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.json config file.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
@@ -8836,6 +9238,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
@@ -8852,6 +9255,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - checkbox located by label | name | CSS | XPath | strict locator.
          * @param [context = null] - (optional, `null` by default) element located by CSS | XPath | strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
@@ -8981,15 +9385,17 @@ declare namespace CodeceptJS {
          * I.seeInTitle('Home Page');
          * ```
          * @param text - text value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInTitle(text: string): void;
         /**
          * Checks that title is equal to provided one.
          *
-         *  ```js
-         *  I.seeTitleEquals('Test title.');
-         *  ```
+         * ```js
+         * I.seeTitleEquals('Test title.');
+         * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTitleEquals(text: string): void;
         /**
@@ -8999,6 +9405,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInTitle('Error');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInTitle(text: string): void;
         /**
@@ -9022,6 +9429,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - expected on page.
          * @param [context = null] - (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -9034,6 +9442,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - element value to check.
          * @param [context = null] - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeTextEquals(text: string, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -9046,7 +9455,7 @@ declare namespace CodeceptJS {
          * ```
          * @param text - which is not present.
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator in which to perfrom search.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          * {{ react }}
          */
@@ -9063,6 +9472,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -9075,6 +9485,7 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @param value - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: string): void;
         /**
@@ -9086,7 +9497,7 @@ declare namespace CodeceptJS {
          * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
@@ -9099,7 +9510,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCheckboxIsChecked('agree'); // located by name
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
@@ -9111,6 +9522,7 @@ declare namespace CodeceptJS {
          * I.seeElement('#modal');
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeElement(locator: CodeceptJS.LocatorOrString): void;
@@ -9121,6 +9533,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElement('.modal'); // modal is not shown
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         dontSeeElement(locator: CodeceptJS.LocatorOrString): void;
@@ -9132,6 +9545,7 @@ declare namespace CodeceptJS {
          * I.seeElementInDOM('#modal');
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -9141,6 +9555,7 @@ declare namespace CodeceptJS {
          * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
          * ```
          * @param locator - located by CSS|XPath|Strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
         /**
@@ -9150,6 +9565,7 @@ declare namespace CodeceptJS {
          * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
          * ```
          * @param text - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInSource(text: string): void;
         /**
@@ -9191,6 +9607,7 @@ declare namespace CodeceptJS {
          * I.dontSeeInSource('<!--'); // no comments in source
          * ```
          * @param value - to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInSource(value: string): void;
         /**
@@ -9203,7 +9620,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeNumberOfElements(locator: CodeceptJS.LocatorOrString, num: number): void;
@@ -9216,7 +9633,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * {{ react }}
          */
         seeNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number): void;
@@ -9228,6 +9645,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param cssProperties - object with CSS properties and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCssPropertiesOnElements(locator: CodeceptJS.LocatorOrString, cssProperties: any): void;
         /**
@@ -9238,6 +9656,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param attributes - attributes and their values to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeAttributesOnElements(locator: CodeceptJS.LocatorOrString, attributes: any): void;
         /**
@@ -9258,11 +9677,13 @@ declare namespace CodeceptJS {
          * I.seeInCurrentUrl('/register'); // we are on registration page
          * ```
          * @param url - a fragment to check
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeInCurrentUrl(url: string): void;
         /**
          * Checks that current url does not contain a provided fragment.
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeInCurrentUrl(url: string): void;
         /**
@@ -9275,6 +9696,7 @@ declare namespace CodeceptJS {
          * I.seeCurrentUrlEquals('http://my.site.com/register');
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCurrentUrlEquals(url: string): void;
         /**
@@ -9286,6 +9708,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
          * ```
          * @param url - value to check.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
@@ -9313,9 +9736,13 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
-         * @returns Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
+         * [!] 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[]): Promise<any>;
+        executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
@@ -9339,8 +9766,9 @@ declare namespace CodeceptJS {
          * ```
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
-        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
+        executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): void;
         /**
          * Scroll element into viewport.
          *
@@ -9351,6 +9779,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by CSS|XPath|strict locator.
          * @param scrollIntoViewOptions - see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollIntoView(locator: LocatorOrString, scrollIntoViewOptions: ScrollIntoViewOptions): void;
         /**
@@ -9364,6 +9793,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -9377,6 +9807,7 @@ declare namespace CodeceptJS {
          * @param locator - located by CSS|XPath|strict locator.
          * @param [offsetX = 0] - (optional, `0` by default) X-axis offset.
          * @param [offsetY = 0] - (optional, `0` by default) Y-axis offset.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         moveCursorTo(locator: CodeceptJS.LocatorOrString, offsetX?: number, offsetY?: number): void;
         /**
@@ -9388,6 +9819,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param fileName - file name to save.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveElementScreenshot(locator: CodeceptJS.LocatorOrString, fileName: string): void;
         /**
@@ -9401,6 +9833,7 @@ declare namespace CodeceptJS {
          * ```
          * @param fileName - file name to save.
          * @param [fullPage = false] - (optional, `false` by default) flag to enable fullscreen screenshot mode.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
@@ -9418,7 +9851,7 @@ declare namespace CodeceptJS {
          * ]);
          * ```
          * @param cookie - a cookie object or array of cookie objects.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * Uses Selenium's JSON [cookie
@@ -9434,6 +9867,7 @@ declare namespace CodeceptJS {
          * I.clearCookie('test');
          * ```
          * @param [cookie = null] - (optional, `null` by default) cookie name
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         clearCookie(cookie?: string): void;
         /**
@@ -9443,6 +9877,7 @@ declare namespace CodeceptJS {
          * I.seeCookie('Auth');
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         seeCookie(name: string): void;
         /**
@@ -9452,6 +9887,7 @@ declare namespace CodeceptJS {
          * I.dontSeeCookie('auth'); // no auth cookie
          * ```
          * @param name - cookie name.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dontSeeCookie(name: string): void;
         /**
@@ -9501,6 +9937,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to press down.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyDown(key: string): void;
         /**
@@ -9514,6 +9951,7 @@ declare namespace CodeceptJS {
          * I.pressKeyUp('Control');
          * ```
          * @param key - name of key to release.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         pressKeyUp(key: string): void;
         /**
@@ -9575,6 +10013,7 @@ declare namespace CodeceptJS {
          * - `'Space'`
          * - `'Tab'`
          * @param key - key or array of keys to press.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          *
          *
          * _Note:_ In case a text field or textarea is focused be aware that some browsers do not respect active modifier when combining modifier keys with other keys.
@@ -9597,6 +10036,7 @@ declare namespace CodeceptJS {
          * ```
          * @param key - or array of keys to type.
          * @param [delay = null] - (optional) delay in ms between key presses
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         type(key: string | string[], delay?: number): void;
         /**
@@ -9604,6 +10044,7 @@ declare namespace CodeceptJS {
          * First parameter can be set to `maximize`.
          * @param width - width in pixels or `maximize`.
          * @param height - height in pixels.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested in web, in apps doesn't work
          */
         resizeWindow(width: number, height: number): void;
@@ -9615,7 +10056,7 @@ declare namespace CodeceptJS {
          * ```
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
-         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          * Appium: not tested
          */
         dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString): void;
@@ -9629,6 +10070,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - located by label|name|CSS|XPath|strict locator.
          * @param offsetX - position to drag.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         dragSlider(locator: CodeceptJS.LocatorOrString, offsetX: number): void;
         /**
@@ -9667,9 +10109,11 @@ declare namespace CodeceptJS {
          * Close all tabs except for the current one.
          *
          *
-         *  ```js
-         *  I.closeOtherTabs();
-         *  ```
+         * ```js
+         * I.closeOtherTabs();
+         * ```
+         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         closeOtherTabs(): void;
         /**
@@ -9679,6 +10123,7 @@ declare namespace CodeceptJS {
          * I.wait(2); // wait 2 secs
          * ```
          * @param sec - number of second to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         wait(sec: number): void;
         /**
@@ -9686,6 +10131,7 @@ declare namespace CodeceptJS {
          * Element can be located by CSS or XPath.
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional) time in seconds to wait, 1 by default.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForEnabled(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9698,6 +10144,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9710,6 +10157,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForClickable(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9720,6 +10168,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitInUrl(urlPart: string, sec?: number): void;
         /**
@@ -9731,6 +10180,7 @@ declare namespace CodeceptJS {
          * ```
          * @param urlPart - value to check.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitUrlEquals(urlPart: string, sec?: number): void;
         /**
@@ -9745,6 +10195,7 @@ declare namespace CodeceptJS {
          * @param text - to wait for.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
          * @param [context = null] - (optional) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForText(text: string, sec?: number, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -9756,6 +10207,7 @@ declare namespace CodeceptJS {
          * @param field - input field.
          * @param value - expected value.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForValue(field: LocatorOrString, value: string, sec?: number): void;
         /**
@@ -9767,6 +10219,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9778,6 +10231,7 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param num - number of elements.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, num: number, sec?: number): void;
         /**
@@ -9789,6 +10243,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForInvisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9800,6 +10255,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9811,6 +10267,7 @@ declare namespace CodeceptJS {
          * ```
          * @param locator - element located by CSS|XPath|strict locator.
          * @param [sec = 1] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForDetached(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -9829,6 +10286,7 @@ declare namespace CodeceptJS {
          * @param fn - to be executed in browser context.
          * @param [argsOrSec = null] - (optional, `1` by default) arguments for function or seconds.
          * @param [sec = null] - (optional, `1` by default) time in seconds to wait
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
@@ -9839,44 +10297,51 @@ declare namespace CodeceptJS {
          * I.switchTo(); // switch back to main page
          * ```
          * @param [locator = null] - (optional, `null` by default) element located by CSS|XPath|strict locator.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchTo(locator?: CodeceptJS.LocatorOrString): void;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab.
          *
-         *  ```js
-         *  I.switchToNextTab();
-         *  I.switchToNextTab(2);
-         *  ```
+         * ```js
+         * I.switchToNextTab();
+         * I.switchToNextTab(2);
+         * ```
          * @param [num = 1] - (optional) number of tabs to switch forward, default: 1.
          * @param [sec = null] - (optional) time in seconds to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchToNextTab(num?: number, sec?: number | null): void;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab.
          *
-         *  ```js
-         *  I.switchToPreviousTab();
-         *  I.switchToPreviousTab(2);
-         *  ```
+         * ```js
+         * I.switchToPreviousTab();
+         * I.switchToPreviousTab(2);
+         * ```
          * @param [num = 1] - (optional) number of tabs to switch backward, default: 1.
          * @param [sec = null] - (optional) time in seconds to wait.
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         switchToPreviousTab(num?: number, sec?: number): void;
         /**
          * Close current tab.
          *
-         *  ```js
-         *  I.closeCurrentTab();
-         *  ```
+         * ```js
+         * I.closeCurrentTab();
+         * ```
+         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         closeCurrentTab(): void;
         /**
          * Open new tab and switch to it.
          *
-         *  ```js
-         *  I.openNewTab();
-         *  ```
+         * ```js
+         * I.openNewTab();
+         * ```
+         *
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         openNewTab(): void;
         /**
@@ -9895,6 +10360,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -9903,6 +10369,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -9911,6 +10378,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -9934,6 +10402,7 @@ declare namespace CodeceptJS {
          * @param latitude - to set.
          * @param longitude - to set
          * @param [altitude = null] - (optional, null by default) to set
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         setGeoLocation(latitude: number, longitude: number, altitude?: number): void;
         /**
@@ -9971,7 +10440,7 @@ declare namespace CodeceptJS {
         /**
          * Placeholder for ~ locator only test case write once run on both Appium and WebDriver.
          */
-        runOnAndroid(): void;
+        runOnAndroid(caps: any, fn: any): void;
         /**
          * Placeholder for ~ locator only test case write once run on both Appium and WebDriver.
          */