codeceptjs 3.5.9 → 3.5.11

package/typings/types.d.ts

@@ -458,7 +458,7 @@ declare namespace CodeceptJS {
          * Switch to the specified context.
          * @param context - the context to switch to
          */
-        _switchToContext(context: any): void;
+        switchToContext(context: any): void;
         /**
          * Switches to web context.
          * If no context is provided switches to the first detected web context
@@ -749,7 +749,7 @@ declare namespace CodeceptJS {
          * ```js
          * I.closeApp();
          * ```
-         * @returns Appium: support only iOS
+         * @returns Appium: support both Android and iOS
          */
         closeApp(): Promise<void>;
         /**
@@ -980,13 +980,13 @@ declare namespace CodeceptJS {
          * I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "center" });
          * ```
          * @param locator - located by CSS|XPath|strict locator.
-         * @param scrollIntoViewOptions - see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
+         * @param scrollIntoViewOptions - either alignToTop=true|false or scrollIntoViewOptions. See https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
          * @returns automatically synchronized promise through #recorder
          *
          *
          * Supported only for web testing
          */
-        scrollIntoView(locator: LocatorOrString, scrollIntoViewOptions: ScrollIntoViewOptions): void;
+        scrollIntoView(locator: LocatorOrString, scrollIntoViewOptions: ScrollIntoViewOptions | boolean): void;
         /**
          * Verifies that the specified checkbox is checked.
          *
@@ -1131,7 +1131,7 @@ declare namespace CodeceptJS {
      * {
      *   helpers: {
      *     Playwright: {...},
-     *     ExpectHelper: {},
+     *     Expect: {},
      *   }
      * }
      * ```
@@ -1139,57 +1139,51 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     class ExpectHelper {
-        expectEqual(actualValue: any, expectedValue: any, customErrorMsg: any): void;
-        expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg: any): void;
-        expectDeepEqual(actualValue: any, expectedValue: any, customErrorMsg: any): void;
-        expectNotDeepEqual(actualValue: any, expectedValue: any, customErrorMsg: any): void;
-        expectContain(actualValue: any, expectedValueToContain: any, customErrorMsg: any): void;
-        expectNotContain(actualValue: any, expectedValueToNotContain: any, customErrorMsg: any): void;
-        expectStartsWith(actualValue: any, expectedValueToStartWith: any, customErrorMsg: any): void;
-        expectNotStartsWith(actualValue: any, expectedValueToNotStartWith: any, customErrorMsg: any): void;
-        expectEndsWith(actualValue: any, expectedValueToEndWith: any, customErrorMsg: any): void;
-        expectNotEndsWith(actualValue: any, expectedValueToNotEndWith: any, customErrorMsg: any): void;
-        expectJsonSchema(targetData: any, jsonSchema: any, customErrorMsg: any): void;
+        expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
+        expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
+        expectDeepEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
+        expectNotDeepEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
+        expectContain(actualValue: any, expectedValueToContain: any, customErrorMsg?: any): void;
+        expectNotContain(actualValue: any, expectedValueToNotContain: any, customErrorMsg?: any): void;
+        expectStartsWith(actualValue: any, expectedValueToStartWith: any, customErrorMsg?: any): void;
+        expectNotStartsWith(actualValue: any, expectedValueToNotStartWith: any, customErrorMsg?: any): void;
+        expectEndsWith(actualValue: any, expectedValueToEndWith: any, customErrorMsg?: any): void;
+        expectNotEndsWith(actualValue: any, expectedValueToNotEndWith: any, customErrorMsg?: any): void;
+        expectJsonSchema(targetData: any, jsonSchema: any, customErrorMsg?: any): void;
         /**
          * @param ajvOptions - Pass AJV options
          */
-        expectJsonSchemaUsingAJV(targetData: any, jsonSchema: any, customErrorMsg: any, ajvOptions: any): void;
-        expectHasProperty(targetData: any, propertyName: any, customErrorMsg: any): void;
-        expectHasAProperty(targetData: any, propertyName: any, customErrorMsg: any): void;
-        expectToBeA(targetData: any, type: any, customErrorMsg: any): void;
-        expectToBeAn(targetData: any, type: any, customErrorMsg: any): void;
-        expectMatchRegex(targetData: any, regex: any, customErrorMsg: any): void;
-        expectLengthOf(targetData: any, length: any, customErrorMsg: any): void;
-        expectEmpty(targetData: any, customErrorMsg: any): void;
-        expectTrue(targetData: any, customErrorMsg: any): void;
-        expectFalse(targetData: any, customErrorMsg: any): void;
-        /**
-         * @param aboveThan - number | Date
-         */
-        expectAbove(targetData: any, aboveThan: any, customErrorMsg: any): void;
-        /**
-         * @param belowThan - number | Date
-         */
-        expectBelow(targetData: any, belowThan: any, customErrorMsg: any): void;
-        expectLengthAboveThan(targetData: any, lengthAboveThan: any, customErrorMsg: any): void;
-        expectLengthBelowThan(targetData: any, lengthBelowThan: any, customErrorMsg: any): void;
-        expectEqualIgnoreCase(actualValue: any, expectedValue: any, customErrorMsg: any): void;
+        expectJsonSchemaUsingAJV(targetData: any, jsonSchema: any, customErrorMsg?: any, ajvOptions: any): void;
+        expectHasProperty(targetData: any, propertyName: any, customErrorMsg?: any): void;
+        expectHasAProperty(targetData: any, propertyName: any, customErrorMsg?: any): void;
+        expectToBeA(targetData: any, type: any, customErrorMsg?: any): void;
+        expectToBeAn(targetData: any, type: any, customErrorMsg?: any): void;
+        expectMatchRegex(targetData: any, regex: any, customErrorMsg?: any): void;
+        expectLengthOf(targetData: any, length: any, customErrorMsg?: any): void;
+        expectEmpty(targetData: any, customErrorMsg?: any): void;
+        expectTrue(targetData: any, customErrorMsg?: any): void;
+        expectFalse(targetData: any, customErrorMsg?: any): void;
+        expectAbove(targetData: any, aboveThan: any, customErrorMsg?: any): void;
+        expectBelow(targetData: any, belowThan: any, customErrorMsg?: any): void;
+        expectLengthAboveThan(targetData: any, lengthAboveThan: any, customErrorMsg?: any): void;
+        expectLengthBelowThan(targetData: any, lengthBelowThan: any, customErrorMsg?: any): void;
+        expectEqualIgnoreCase(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
         /**
          * expects members of two arrays are deeply equal
          */
-        expectDeepMembers(actualValue: any, expectedValue: any, customErrorMsg: any): void;
+        expectDeepMembers(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
         /**
          * expects an array to be a superset of another array
          */
-        expectDeepIncludeMembers(superset: any, set: any, customErrorMsg: any): void;
+        expectDeepIncludeMembers(superset: any, set: any, customErrorMsg?: any): void;
         /**
          * expects members of two JSON objects are deeply equal excluding some properties
          */
-        expectDeepEqualExcluding(actualValue: any, expectedValue: any, fieldsToExclude: any, customErrorMsg: any): void;
+        expectDeepEqualExcluding(actualValue: any, expectedValue: any, fieldsToExclude: any, customErrorMsg?: any): void;
         /**
          * expects a JSON object matches a provided pattern
          */
-        expectMatchesPattern(actualValue: any, expectedPattern: any, customErrorMsg: any): void;
+        expectMatchesPattern(actualValue: any, expectedPattern: any, customErrorMsg?: any): void;
     }
     /**
      * Helper for testing filesystem.
@@ -2848,6 +2842,7 @@ declare namespace CodeceptJS {
      * @property [ignoreHTTPSErrors] - Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
      * @property [bypassCSP] - bypass Content Security Policy or CSP
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+     * @property [recordHar] - record HAR and will be saved to `output/har`. See more of [HAR options](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har).
      */
     type PlaywrightConfig = {
         url?: string;
@@ -2884,6 +2879,7 @@ declare namespace CodeceptJS {
         ignoreHTTPSErrors?: boolean;
         bypassCSP?: boolean;
         highlightElement?: boolean;
+        recordHar?: any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -2929,6 +2925,21 @@ declare namespace CodeceptJS {
      * * `trace`: enables trace recording for failed tests; trace are saved into `output/trace` folder
      * * `keepTraceForPassedTests`: - save trace for passed tests
      *
+     * #### HAR Recording Customization
+     *
+     * A HAR file is an HTTP Archive file that contains a record of all the network requests that are made when a page is loaded.
+     * It contains information about the request and response headers, cookies, content, timings, and more. You can use HAR files to mock network requests in your tests.
+     * HAR will be saved to `output/har`. More info could be found here https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har.
+     *
+     * ```
+     * ...
+     * recordHar: {
+     *     mode: 'minimal', // possible values: 'minimal'|'full'.
+     *     content: 'embed' // possible values:  "omit"|"embed"|"attach".
+     * }
+     * ...
+     * ```
+     *
      * #### Example #1: Wait for 0 network connections.
      *
      * ```js
@@ -3103,7 +3114,7 @@ declare namespace CodeceptJS {
          * });
          * ```
          * @param description - used to show in logs.
-         * @param fn - async function that executed with Playwright helper as argumen
+         * @param fn - async function that executed with Playwright helper as arguments
          */
         usePlaywrightTo(description: string, fn: (...params: any[]) => any): void;
         /**
@@ -3190,15 +3201,8 @@ declare namespace CodeceptJS {
          */
         amOnPage(url: string): 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 automatically synchronized promise through #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.
+         * Playwright does not control the window of a browser, so it can't adjust its real size.
          * It also can't maximize a window.
          *
          * Update configuration to change real window size on start:
@@ -3208,6 +3212,12 @@ declare namespace CodeceptJS {
          * // @codeceptjs/configure package must be installed
          * { setWindowSize } = require('@codeceptjs/configure');
          * ````
+         *
+         * 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 automatically synchronized promise through #recorder
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -3283,6 +3293,13 @@ declare namespace CodeceptJS {
          */
         grabDisabledElementStatus(locator: CodeceptJS.LocatorOrString, options?: any): Promise<boolean>;
         /**
+         * ```js
+         * // specify coordinates for source position
+         * I.dragAndDrop('img.src', 'img.dst', { sourcePosition: {x: 10, y: 10} })
+         * ```
+         *
+         * > When no option is set, custom drag and drop would be used, to use the dragAndDrop API from Playwright, please set options, for example `force: true`
+         *
          * Drag an item to a destination element.
          *
          * ```js
@@ -3291,13 +3308,6 @@ declare namespace CodeceptJS {
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
          * @param [options] - [Additional options](https://playwright.dev/docs/api/class-page#page-drag-and-drop) can be passed as 3rd argument.
-         *
-         * ```js
-         * // specify coordinates for source position
-         * I.dragAndDrop('img.src', 'img.dst', { sourcePosition: {x: 10, y: 10} })
-         * ```
-         *
-         * > When no option is set, custom drag and drop would be used, to use the dragAndDrop API from Playwright, please set options, for example `force: true`
          * @returns automatically synchronized promise through #recorder
          */
         dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString, options?: any): void;
@@ -3324,6 +3334,22 @@ declare namespace CodeceptJS {
          * @returns automatically synchronized promise through #recorder
          */
         refreshPage(): void;
+        /**
+         * Replaying from HAR
+         *
+         * ```js
+         *  // Replay API requests from HAR.
+         *  // Either use a matching response from the HAR,
+         *  // or abort the request if nothing matches.
+         *    I.replayFromHar('./output/har/something.har', { url: "*\/**\/api/v1/fruits" });
+         *    I.amOnPage('https://demo.playwright.dev/api-mocking');
+         *    I.see('CodeceptJS');
+         * ```
+         * @param harFilePath - Path to recorded HAR file
+         * @param [opts] - [Options for replaying from HAR](https://playwright.dev/docs/api/class-page#page-route-from-har)
+         * @returns Promise<void>
+         */
+        replayFromHar(harFilePath: string, opts?: any): any;
         /**
          * Scroll page to the top.
          *
@@ -3449,6 +3475,28 @@ declare namespace CodeceptJS {
          * ```
          */
         _locateFields(): void;
+        /**
+         * Grab WebElements for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElements = await I.grabWebElements('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
+        /**
+         * Grab WebElement for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElement = await I.grabWebElement('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElement(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab
          *
@@ -3588,12 +3636,7 @@ declare namespace CodeceptJS {
          * // using strict locator
          * I.click({css: 'nav a.login'});
          * ```
-         * @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.
-         * @param [options] - [Additional options](https://playwright.dev/docs/api/class-page#page-click) for click available as 3rd argument.
-         *
-         * Examples:
-         *
+         * @example
          * ```js
          * // click on element at position
          * I.click('canvas', '.model', { position: { x: 20, y: 40 } })
@@ -3601,6 +3644,9 @@ declare namespace CodeceptJS {
          * // make ctrl-click
          * I.click('.edit', null, { modifiers: ['Ctrl'] } )
          * ```
+         * @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.
+         * @param [options] - [Additional options](https://playwright.dev/docs/api/class-page#page-click) for click available as 3rd argument.
          * @returns automatically synchronized promise through #recorder
          */
         click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null, options?: any): void;
@@ -3670,6 +3716,16 @@ declare namespace CodeceptJS {
          */
         rightClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
+         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
+         *
+         * Examples:
+         *
+         * ```js
+         * // click on element at position
+         * I.checkOption('Agree', '.signup', { position: { x: 5, y: 5 } })
+         * ```
+         * > ⚠️ To avoid flakiness, option `force: true` is set by default
+         *
          * Selects a checkbox or radio button.
          * Element is located by label or name or CSS or XPath.
          *
@@ -3683,20 +3739,19 @@ 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 automatically synchronized promise through #recorder
-         *
-         *
-         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
+         */
+        checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck) for uncheck available as 3rd argument.
          *
          * Examples:
          *
          * ```js
          * // click on element at position
-         * I.checkOption('Agree', '.signup', { position: { x: 5, y: 5 } })
+         * I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
          * ```
          * > ⚠️ To avoid flakiness, option `force: true` is set by default
-         */
-        checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
-        /**
+         *
          * Unselects a checkbox or radio button.
          * Element is located by label or name or CSS or XPath.
          *
@@ -3710,17 +3765,6 @@ 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 automatically synchronized promise through #recorder
-         *
-         *
-         * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck) for uncheck available as 3rd argument.
-         *
-         * Examples:
-         *
-         * ```js
-         * // click on element at position
-         * I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
-         * ```
-         * > ⚠️ To avoid flakiness, option `force: true` is set by default
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -3776,6 +3820,8 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): void;
         /**
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         *
          * Presses a key in the browser (on a focused element).
          *
          * _Hint:_ For populating text field or textarea, it is recommended to use [`fillField`](#fillfield).
@@ -3835,9 +3881,6 @@ declare namespace CodeceptJS {
          * - `'Tab'`
          * @param key - key or array of keys to press.
          * @returns automatically synchronized promise through #recorder
-         *
-         *
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
          */
         pressKey(key: string | string[]): void;
         /**
@@ -4185,6 +4228,8 @@ declare namespace CodeceptJS {
          */
         dontSeeCookie(name: string): void;
         /**
+         * Returns cookie in JSON format. If name not passed returns all cookies for this domain.
+         *
          * Gets a cookie object by name.
          * If none provided gets all cookies.
          * Resumes test execution, so **should be used inside async function with `await`** operator.
@@ -4195,9 +4240,6 @@ declare namespace CodeceptJS {
          * ```
          * @param [name = null] - cookie name.
          * @returns attribute value
-         *
-         *
-         * Returns cookie in JSON format. If name not passed returns all cookies for this domain.
          */
         grabCookie(name?: string): any;
         /**
@@ -4223,8 +4265,8 @@ declare namespace CodeceptJS {
          * ```js
          * I.executeScript(({x, y}) => x + y, {x, y});
          * ```
-         * You can pass only one parameter into a function
-         * but you can pass in array or object.
+         * You can pass only one parameter into a function,
+         * or you can pass in array or object.
          *
          * ```js
          * I.executeScript(([x, y]) => x + y, [x, y]);
@@ -4504,6 +4546,8 @@ declare namespace CodeceptJS {
          */
         waitForElement(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
+         * This method accepts [React selectors](https://codecept.io/react).
+         *
          * Waits for an element to become visible on a page (by default waits for 1sec).
          * Element can be located by CSS or XPath.
          *
@@ -4513,9 +4557,6 @@ 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 automatically synchronized promise through #recorder
-         *
-         *
-         * This method accepts [React selectors](https://codecept.io/react).
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -6542,16 +6583,15 @@ declare namespace CodeceptJS {
          */
         amOnPage(url: string): void;
         /**
+         * 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.
+         * It also can't maximize a window.
+         *
          * 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 automatically synchronized promise through #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.
-         * It also can't maximize a window.
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -6730,7 +6770,7 @@ declare namespace CodeceptJS {
          */
         _locate(): void;
         /**
-         * Find a checkbox by providing human readable text:
+         * Find a checkbox by providing human-readable text:
          * NOTE: Assumes the checkable element exists
          *
          * ```js
@@ -6739,7 +6779,7 @@ declare namespace CodeceptJS {
          */
         _locateCheckable(): void;
         /**
-         * Find a clickable element by providing human readable text:
+         * Find a clickable element by providing human-readable text:
          *
          * ```js
          * this.helpers['Puppeteer']._locateClickable('Next page').then // ...
@@ -6747,13 +6787,24 @@ declare namespace CodeceptJS {
          */
         _locateClickable(): void;
         /**
-         * Find field elements by providing human readable text:
+         * Find field elements by providing human-readable text:
          *
          * ```js
          * this.helpers['Puppeteer']._locateFields('Your email').then // ...
          * ```
          */
         _locateFields(): void;
+        /**
+         * Grab WebElements for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElements = await I.grabWebElements('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Switch focus to a particular tab by its number. It waits tabs loading and then switch tab
          *
@@ -6933,7 +6984,7 @@ declare namespace CodeceptJS {
          * Sets a directory to where save files. Allows to test file downloads.
          * Should be used with [FileSystem helper](https://codecept.io/helpers/FileSystem) to check that file were downloaded correctly.
          *
-         * By default files are saved to `output/downloads`.
+         * By default, files are saved to `output/downloads`.
          * This directory is cleaned on every `handleDownloads` call, to ensure no old files are kept.
          *
          * ```js
@@ -7074,6 +7125,8 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): void;
         /**
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         *
          * Presses a key in the browser (on a focused element).
          *
          * _Hint:_ For populating text field or textarea, it is recommended to use [`fillField`](#fillfield).
@@ -7133,9 +7186,6 @@ declare namespace CodeceptJS {
          * - `'Tab'`
          * @param key - key or array of keys to press.
          * @returns automatically synchronized promise through #recorder
-         *
-         *
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
          */
         pressKey(key: string | string[]): void;
         /**
@@ -7240,6 +7290,8 @@ declare namespace CodeceptJS {
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
+         * > ⚠ 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.
+         *
          * Attaches a file to element located by label, name, CSS or XPath
          * Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
          * File will be uploaded to remote system (if tests are running remotely).
@@ -7251,9 +7303,6 @@ declare namespace CodeceptJS {
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.conf.ts or codecept.conf.js config file.
          * @returns automatically synchronized promise through #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.
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
         /**
@@ -7524,6 +7573,8 @@ declare namespace CodeceptJS {
          */
         clearCookie(cookie?: string): void;
         /**
+         * If a function returns a Promise, tt will wait for its resolution.
+         *
          * Executes sync script on a page.
          * Pass arguments to function as additional parameters.
          * Will return execution result to a test.
@@ -7549,12 +7600,10 @@ declare namespace CodeceptJS {
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
          * @returns script return value
-         *
-         *
-         * If a function returns a Promise It will wait for it resolution.
          */
         executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
+         * Asynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
          * Executes async script on page.
          * Provided function should execute a passed callback (as first argument) to signal it is finished.
          *
@@ -7578,9 +7627,6 @@ declare namespace CodeceptJS {
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
          * @returns script return value
-         *
-         *
-         * Asynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
          */
         executeAsyncScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
@@ -7865,7 +7911,7 @@ declare namespace CodeceptJS {
          * @returns automatically synchronized promise through #recorder
          *
          *
-         * This method accepts [React selectors](https://codecept.io/react).
+         * {{ react }}
          */
         waitForVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
@@ -7981,9 +8027,9 @@ declare namespace CodeceptJS {
          */
         waitForFunction(fn: string | ((...params: any[]) => any), argsOrSec?: any[] | number, sec?: number): void;
         /**
-         * Waits for navigation to finish. By default takes configured `waitForNavigation` option.
+         * Waits for navigation to finish. By default, takes configured `waitForNavigation` option.
          *
-         * See [Pupeteer's reference](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions)
+         * See [Puppeteer's reference](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions)
          */
         waitForNavigation(opts: any): void;
         /**
@@ -9620,6 +9666,17 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          */
         _locateFields(locator: CodeceptJS.LocatorOrString): void;
+        /**
+         * Grab WebElements for given locator
+         * Resumes test execution, so **should be used inside an async function with `await`** operator.
+         *
+         * ```js
+         * const webElements = await I.grabWebElements('#button');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @returns WebElement of being used Web helper
+         */
+        grabWebElements(locator: CodeceptJS.LocatorOrString): Promise<any>;
         /**
          * Set [WebDriver timeouts](https://webdriver.io/docs/timeouts.html) in realtime.
          *
@@ -9843,6 +9900,8 @@ declare namespace CodeceptJS {
          */
         selectOption(select: LocatorOrString, option: string | any[]): void;
         /**
+         * Appium: not tested
+         *
          * Attaches a file to element located by label, name, CSS or XPath
          * Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
          * File will be uploaded to remote system (if tests are running remotely).
@@ -9854,11 +9913,10 @@ declare namespace CodeceptJS {
          * @param locator - field located by label|name|CSS|XPath|strict locator.
          * @param pathToFile - local file path relative to codecept.conf.ts or codecept.conf.js config file.
          * @returns automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         attachFile(locator: CodeceptJS.LocatorOrString, pathToFile: string): void;
         /**
+         * Appium: not tested
          * Selects a checkbox or radio button.
          * Element is located by label or name or CSS or XPath.
          *
@@ -9872,11 +9930,10 @@ 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 automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         checkOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
+         * Appium: not tested
          * Unselects a checkbox or radio button.
          * Element is located by label or name or CSS or XPath.
          *
@@ -9890,8 +9947,6 @@ 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 automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         uncheckOption(field: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
@@ -10126,6 +10181,7 @@ declare namespace CodeceptJS {
          */
         dontSeeInField(field: CodeceptJS.LocatorOrString, value: CodeceptJS.StringOrSecret): void;
         /**
+         * Appium: not tested
          * Verifies that the specified checkbox is checked.
          *
          * ```js
@@ -10135,11 +10191,10 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @returns automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         seeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
+         * Appium: not tested
          * Verifies that the specified checkbox is not checked.
          *
          * ```js
@@ -10149,8 +10204,6 @@ declare namespace CodeceptJS {
          * ```
          * @param field - located by label|name|CSS|XPath|strict locator.
          * @returns automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         dontSeeCheckboxIsChecked(field: CodeceptJS.LocatorOrString): void;
         /**
@@ -10355,6 +10408,8 @@ declare namespace CodeceptJS {
          */
         dontSeeCurrentUrlEquals(url: string): void;
         /**
+         * Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
+         *
          * Executes sync script on a page.
          * Pass arguments to function as additional parameters.
          * Will return execution result to a test.
@@ -10380,10 +10435,6 @@ declare namespace CodeceptJS {
          * @param fn - function to be executed in browser context.
          * @param args - to be passed to function.
          * @returns script return value
-         *
-         *
-         *
-         * Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
          */
         executeScript(fn: string | ((...params: any[]) => any), ...args: any[]): Promise<any>;
         /**
@@ -10421,10 +10472,10 @@ declare namespace CodeceptJS {
          * I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "center" });
          * ```
          * @param locator - located by CSS|XPath|strict locator.
-         * @param scrollIntoViewOptions - see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
+         * @param scrollIntoViewOptions - either alignToTop=true|false or scrollIntoViewOptions. See https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView.
          * @returns automatically synchronized promise through #recorder
          */
-        scrollIntoView(locator: LocatorOrString, scrollIntoViewOptions: ScrollIntoViewOptions): void;
+        scrollIntoView(locator: LocatorOrString, scrollIntoViewOptions: ScrollIntoViewOptions | boolean): void;
         /**
          * Scrolls to element matched by locator.
          * Extra shift can be set with offsetX and offsetY options.
@@ -10480,6 +10531,7 @@ declare namespace CodeceptJS {
          */
         saveScreenshot(fileName: string, fullPage?: boolean): void;
         /**
+         * Uses Selenium's JSON [cookie format](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object).
          * Sets cookie(s).
          *
          * Can be a single cookie object or an array of cookies:
@@ -10495,11 +10547,6 @@ declare namespace CodeceptJS {
          * ```
          * @param cookie - a cookie object or array of cookie objects.
          * @returns automatically synchronized promise through #recorder
-         *
-         *
-         *
-         * Uses Selenium's JSON [cookie
-         * format](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object).
          */
         setCookie(cookie: Cookie | Cookie[]): void;
         /**
@@ -10553,7 +10600,7 @@ declare namespace CodeceptJS {
          */
         acceptPopup(): void;
         /**
-         * Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
+         * Dismisses the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`.
          */
         cancelPopup(): void;
         /**
@@ -10598,6 +10645,8 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): void;
         /**
+         * _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.
+         *
          * Presses a key in the browser (on a focused element).
          *
          * _Hint:_ For populating text field or textarea, it is recommended to use [`fillField`](#fillfield).
@@ -10657,9 +10706,6 @@ declare namespace CodeceptJS {
          * - `'Tab'`
          * @param key - key or array of keys to press.
          * @returns automatically synchronized promise through #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.
          */
         pressKey(key: string | string[]): void;
         /**
@@ -10686,13 +10732,13 @@ declare namespace CodeceptJS {
          */
         type(key: string | string[], delay?: number): void;
         /**
+         * Appium: not tested in web, in apps doesn't work
+         *
          * 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 automatically synchronized promise through #recorder
-         *
-         * Appium: not tested in web, in apps doesn't work
          */
         resizeWindow(width: number, height: number): void;
         /**
@@ -10731,6 +10777,7 @@ declare namespace CodeceptJS {
          */
         blur(locator: CodeceptJS.LocatorOrString, options?: any): void;
         /**
+         * Appium: not tested
          * Drag an item to a destination element.
          *
          * ```js
@@ -10739,8 +10786,6 @@ declare namespace CodeceptJS {
          * @param srcElement - located by CSS|XPath|strict locator.
          * @param destElement - located by CSS|XPath|strict locator.
          * @returns automatically synchronized promise through #recorder
-         *
-         * Appium: not tested
          */
         dragAndDrop(srcElement: LocatorOrString, destElement: LocatorOrString): void;
         /**
@@ -11354,6 +11399,7 @@ declare namespace CodeceptJS {
         const workers: {
             before: 'workers.before';
             after: 'workers.after';
+            result: 'workers.result';
         };
         function emit(event: string, param?: any): void;
         /**