codeceptjs 3.3.0 → 3.3.3

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;
         /**
@@ -2603,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()`.
@@ -2723,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
      * {
@@ -2736,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
@@ -2771,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;
         /**
@@ -2814,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;
         /**
@@ -2847,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;
         /**
@@ -2854,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.
@@ -2890,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;
         /**
@@ -2900,9 +2995,8 @@ declare namespace CodeceptJS {
          * ```
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
-         *
-         *
-         * [Additional options](https://playwright.dev/docs/api/class-page#page-drag-and-drop) can be passed as 3rd argument.
+         * [!] 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
@@ -2911,13 +3005,14 @@ declare namespace CodeceptJS {
          *
          * > 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;
         /**
@@ -2926,6 +3021,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -2934,6 +3030,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -2947,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;
         /**
@@ -2956,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;
         /**
@@ -2971,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;
         /**
@@ -2984,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;
         /**
@@ -3097,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;
         /**
@@ -3106,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;
         /**
@@ -3116,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;
         /**
@@ -3125,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;
         /**
@@ -3142,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.
@@ -3167,9 +3272,8 @@ 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.
-         *
-         *
-         * [Additional options](https://playwright.dev/docs/api/class-page#page-click) for click available as 3rd argument.
+         * [!] 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:
          *
@@ -3181,7 +3285,7 @@ declare namespace CodeceptJS {
          * 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)
          */
@@ -3213,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;
         /**
@@ -3227,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;
         /**
@@ -3242,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;
         /**
@@ -3257,6 +3364,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
          *
          * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
          *
@@ -3282,6 +3390,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
          *
          * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck) for uncheck available as 3rd argument.
          *
@@ -3303,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;
         /**
@@ -3314,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;
         /**
@@ -3327,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;
         /**
@@ -3340,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;
         /**
@@ -3401,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)).
@@ -3423,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;
         /**
@@ -3441,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;
         /**
@@ -3452,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;
         /**
@@ -3463,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;
         /**
@@ -3477,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;
         /**
@@ -3489,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;
         /**
@@ -3502,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;
         /**
@@ -3525,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;
         /**
@@ -3545,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;
         /**
@@ -3562,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;
         /**
@@ -3573,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;
         /**
@@ -3586,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;
         /**
@@ -3596,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;
         /**
@@ -3608,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;
         /**
@@ -3647,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;
         /**
@@ -3656,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;
         /**
@@ -3668,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;
         /**
@@ -3679,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;
         /**
@@ -3696,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;
         /**
@@ -3705,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;
         /**
@@ -3714,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;
         /**
@@ -3741,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;
         /**
@@ -3765,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
          */
@@ -3872,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;
         /**
@@ -3882,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;
         /**
@@ -3894,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;
         /**
@@ -3930,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;
         /**
@@ -3943,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;
         /**
@@ -3969,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;
         /**
@@ -3976,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;
         /**
@@ -3987,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;
         /**
@@ -3998,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;
         /**
@@ -4010,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;
         /**
@@ -4022,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;
         /**
@@ -4033,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).
          */
@@ -4047,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;
         /**
@@ -4058,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;
         /**
@@ -4068,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;
         /**
@@ -4079,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;
         /**
@@ -4093,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;
         /**
@@ -4123,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;
         /**
@@ -4141,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;
         /**
@@ -4158,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;
         /**
@@ -4180,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.
@@ -4213,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`.
          *
@@ -4225,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
@@ -4430,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;
         /**
@@ -4456,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.
@@ -4470,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;
         /**
@@ -4485,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;
         /**
@@ -4498,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;
         /**
@@ -4511,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;
         /**
@@ -4521,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;
         /**
@@ -4533,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;
         /**
@@ -4578,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;
         /**
@@ -4596,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;
         /**
@@ -4609,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;
@@ -4623,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;
         /**
@@ -4637,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;
         /**
@@ -4649,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;
         /**
@@ -4660,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;
         /**
@@ -4671,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;
         /**
@@ -4686,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;
         /**
@@ -4701,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;
         /**
@@ -4712,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;
         /**
@@ -4723,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;
         /**
@@ -4851,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;
         /**
@@ -4869,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;
         /**
@@ -4889,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;
         /**
@@ -4898,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;
         /**
@@ -4908,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;
         /**
@@ -4917,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;
         /**
@@ -4926,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;
         /**
@@ -4945,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;
         /**
@@ -4957,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;
         /**
@@ -4968,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;
         /**
@@ -4989,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;
         /**
@@ -4999,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;
         /**
@@ -5026,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.
@@ -5051,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.
          *
@@ -5060,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;
         /**
@@ -5077,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;
         /**
@@ -5088,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;
         /**
@@ -5099,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;
         /**
@@ -5112,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;
         /**
@@ -5123,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;
         /**
@@ -5132,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;
         /**
@@ -5141,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;
         /**
@@ -5177,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;
         /**
@@ -5192,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;
         /**
@@ -5202,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;
         /**
@@ -5269,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;
         /**
@@ -5278,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;
         /**
@@ -5290,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;
         /**
@@ -5301,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;
         /**
@@ -5320,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;
         /**
@@ -5331,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;
         /**
@@ -5342,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;
         /**
@@ -5353,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;
         /**
@@ -5360,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;
         /**
@@ -5371,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;
         /**
@@ -5389,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;
         /**
@@ -5399,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;
         /**
@@ -5410,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;
         /**
@@ -5424,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;
         /**
@@ -5436,6 +5654,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -5453,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;
         /**
@@ -5461,6 +5681,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -5469,6 +5690,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -5515,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;
     }
@@ -5724,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;
         /**
@@ -5757,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;
         /**
@@ -5764,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.
@@ -5792,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;
@@ -5804,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;
         /**
@@ -5812,6 +6039,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -5820,6 +6048,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -5828,6 +6057,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -5841,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;
         /**
@@ -5850,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;
         /**
@@ -5865,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;
         /**
@@ -5878,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;
         /**
@@ -5986,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;
@@ -5996,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;
@@ -6007,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;
         /**
@@ -6016,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;
         /**
@@ -6042,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.
@@ -6074,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 }}
@@ -6087,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 }}
          */
@@ -6126,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 }}
          */
@@ -6144,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 }}
          */
@@ -6162,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;
         /**
@@ -6177,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;
         /**
@@ -6188,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;
         /**
@@ -6199,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;
         /**
@@ -6212,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;
         /**
@@ -6225,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;
         /**
@@ -6286,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)).
@@ -6308,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;
         /**
@@ -6326,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;
@@ -6339,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;
         /**
@@ -6350,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 }}
          */
@@ -6366,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;
         /**
@@ -6378,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;
         /**
@@ -6391,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.
          */
@@ -6416,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;
         /**
@@ -6437,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;
         /**
@@ -6454,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;
         /**
@@ -6465,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;
         /**
@@ -6478,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 }}
          */
@@ -6490,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;
         /**
@@ -6502,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 }}
          */
@@ -6544,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;
         /**
@@ -6553,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;
         /**
@@ -6565,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 }}
          */
@@ -6579,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 }}
          */
@@ -6599,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;
         /**
@@ -6608,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;
         /**
@@ -6617,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;
         /**
@@ -6644,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;
         /**
@@ -6671,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.
@@ -6697,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.
@@ -6810,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;
@@ -6821,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;
@@ -6834,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;
@@ -6875,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;
         /**
@@ -6888,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;
         /**
@@ -6897,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;
         /**
@@ -6904,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;
         /**
@@ -6915,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;
         /**
@@ -6926,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;
@@ -6939,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;
         /**
@@ -6951,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;
@@ -6963,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).
          */
@@ -6977,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;
         /**
@@ -6988,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;
         /**
@@ -6998,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;
         /**
@@ -7009,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;
         /**
@@ -7023,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;
         /**
@@ -7053,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;
         /**
@@ -7071,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;
         /**
@@ -7088,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;
         /**
@@ -7110,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.
@@ -7190,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
@@ -7449,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;
         /**
@@ -7456,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;
         /**
@@ -7482,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;
         /**
@@ -7501,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;
         /**
@@ -7519,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;
         /**
@@ -7530,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;
         /**
@@ -7541,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;
         /**
@@ -7554,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;
         /**
@@ -7567,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 }}
          */
@@ -7582,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;
         /**
@@ -7596,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;
         /**
@@ -7611,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;
         /**
@@ -7626,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;
         /**
@@ -7641,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;
         /**
@@ -7652,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;
         /**
@@ -7663,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;
         /**
@@ -7686,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;
         /**
@@ -7695,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;
         /**
@@ -7712,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;
         /**
@@ -7723,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;
         /**
@@ -7736,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;
         /**
@@ -7748,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;
         /**
@@ -7758,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;
         /**
@@ -7767,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;
         /**
@@ -7777,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;
         /**
@@ -7786,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;
         /**
@@ -7797,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;
         /**
@@ -7822,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;
         /**
@@ -7834,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;
         /**
@@ -7851,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;
         /**
@@ -7860,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;
         /**
@@ -7871,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;
         /**
@@ -7884,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;
         /**
@@ -7893,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;
         /**
@@ -7920,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.
@@ -8041,6 +8373,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -8049,6 +8382,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -8062,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;
         /**
@@ -8072,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;
         /**
@@ -8089,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;
         /**
@@ -8098,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;
         /**
@@ -8107,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;
         /**
@@ -8134,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;
         /**
@@ -8144,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;
         /**
@@ -8155,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;
         /**
@@ -8173,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;
         /**
@@ -8184,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;
         /**
@@ -8196,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;
         /**
@@ -8207,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;
         /**
@@ -8218,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;
         /**
@@ -8232,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;
     }
@@ -8669,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;
         /**
@@ -8695,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.
@@ -8727,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 }}
@@ -8744,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 }}
          */
@@ -8762,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 }}
          */
@@ -8784,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 }}
          */
@@ -8805,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 }}
          */
@@ -8819,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;
@@ -8831,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;
         /**
@@ -8854,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;
         /**
@@ -8867,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;
@@ -8883,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;
@@ -8899,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;
@@ -9028,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;
         /**
@@ -9046,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;
         /**
@@ -9069,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 }}
          */
@@ -9081,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;
         /**
@@ -9093,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 }}
          */
@@ -9110,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;
         /**
@@ -9122,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;
         /**
@@ -9133,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;
@@ -9146,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;
@@ -9158,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;
@@ -9168,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;
@@ -9179,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;
         /**
@@ -9188,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;
         /**
@@ -9197,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;
         /**
@@ -9238,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;
         /**
@@ -9250,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;
@@ -9263,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;
@@ -9275,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;
         /**
@@ -9285,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;
         /**
@@ -9305,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;
         /**
@@ -9322,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;
         /**
@@ -9333,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;
         /**
@@ -9360,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.
@@ -9386,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.
          *
@@ -9398,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;
         /**
@@ -9411,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;
         /**
@@ -9424,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;
         /**
@@ -9435,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;
         /**
@@ -9448,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;
         /**
@@ -9465,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
@@ -9481,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;
         /**
@@ -9490,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;
         /**
@@ -9499,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;
         /**
@@ -9548,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;
         /**
@@ -9561,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;
         /**
@@ -9622,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.
@@ -9644,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;
         /**
@@ -9651,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;
@@ -9662,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;
@@ -9676,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;
         /**
@@ -9714,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;
         /**
@@ -9726,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;
         /**
@@ -9733,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;
         /**
@@ -9745,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;
         /**
@@ -9757,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;
         /**
@@ -9767,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;
         /**
@@ -9778,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;
         /**
@@ -9792,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;
         /**
@@ -9803,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;
         /**
@@ -9814,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;
         /**
@@ -9825,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;
         /**
@@ -9836,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;
         /**
@@ -9847,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;
         /**
@@ -9858,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;
         /**
@@ -9876,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;
         /**
@@ -9886,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;
         /**
@@ -9942,6 +10360,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.refreshPage();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         refreshPage(): void;
         /**
@@ -9950,6 +10369,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToTop();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToTop(): void;
         /**
@@ -9958,6 +10378,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.scrollPageToBottom();
          * ```
+         * [!] returns a _promise_ which is synchronized internally by recorder
          */
         scrollPageToBottom(): void;
         /**
@@ -9981,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;
         /**
@@ -10018,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.
          */