codeceptjs 4.2.0 → 4.2.1-beta.1

package/docs/helpers/Playwright.md

@@ -39,49 +39,49 @@ Using playwright-core package, will prevent the download of browser binaries and
 
 This helper should be configured in codecept.conf.(js|ts)
 
-Type: [object][6]
+Type: [object][8]
 
 ### Properties
 
-*   `url` **[string][9]?** base url of website to be tested
+*   `url` **[string][7]?** base url of website to be tested
 *   `browser` **(`"chromium"` | `"firefox"` | `"webkit"` | `"electron"`)?** a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
-*   `show` **[boolean][27]?** show browser window.
-*   `restart` **([string][9] | [boolean][27])?** restart strategy between tests. Possible values:*   'context' or **false** - restarts [browser context][44] but keeps running browser. Recommended by Playwright team to keep tests isolated.
+*   `show` **[boolean][26]?** show browser window.
+*   `restart` **([string][7] | [boolean][26])?** restart strategy between tests. Possible values:*   'context' or **false** - restarts [browser context][44] but keeps running browser. Recommended by Playwright team to keep tests isolated.
     *   'session' or 'keep' - keeps browser context and session, but cleans up cookies and localStorage between tests. The fastest option when running tests in windowed mode. Works with `keepCookies` and `keepBrowserState` options. This behavior was default before CodeceptJS 3.1
-*   `timeout` **[number][18]?** *   [timeout][45] in ms of all Playwright actions .
-*   `disableScreenshots` **[boolean][27]?** don't save screenshot on failure.
+*   `timeout` **[number][17]?** *   [timeout][45] in ms of all Playwright actions .
+*   `disableScreenshots` **[boolean][26]?** don't save screenshot on failure.
 *   `emulate` **any?** browser in device emulation mode.
-*   `video` **[boolean][27]?** enables video recording for failed tests; videos are saved into `output/videos` folder
-*   `keepVideoForPassedTests` **[boolean][27]?** save videos for passed tests; videos are saved into `output/videos` folder
-*   `trace` **[boolean][27]?** record [tracing information][46] with screenshots and snapshots.
-*   `keepTraceForPassedTests` **[boolean][27]?** save trace for passed tests.
-*   `fullPageScreenshots` **[boolean][27]?** make full page screenshots on failure.
-*   `uniqueScreenshotNames` **[boolean][27]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
-*   `keepBrowserState` **[boolean][27]?** keep browser state between tests when `restart` is set to 'session'.
-*   `keepCookies` **[boolean][27]?** keep cookies between tests when `restart` is set to 'session'.
-*   `waitForAction` **[number][18]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-*   `waitForNavigation` **(`"load"` | `"domcontentloaded"` | `"commit"`)?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `commit`. Choose one of those options is possible. See [Playwright API][43].
-*   `pressKeyDelay` **[number][18]?** Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
-*   `getPageTimeout` **[number][18]?** config option to set maximum navigation time in milliseconds.
-*   `waitForTimeout` **[number][18]?** default wait* timeout in ms. Default: 1000.
-*   `basicAuth` **[object][6]?** the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
-*   `windowSize` **[string][9]?** default window size. Set a dimension like `640x480`.
+*   `video` **[boolean][26]?** enables video recording for failed tests; videos are saved into `output/videos` folder
+*   `keepVideoForPassedTests` **[boolean][26]?** save videos for passed tests; videos are saved into `output/videos` folder
+*   `trace` **[boolean][26]?** record [tracing information][46] with screenshots and snapshots.
+*   `keepTraceForPassedTests` **[boolean][26]?** save trace for passed tests.
+*   `fullPageScreenshots` **[boolean][26]?** make full page screenshots on failure.
+*   `uniqueScreenshotNames` **[boolean][26]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+*   `keepBrowserState` **[boolean][26]?** keep browser state between tests when `restart` is set to 'session'.
+*   `keepCookies` **[boolean][26]?** keep cookies between tests when `restart` is set to 'session'.
+*   `waitForAction` **[number][17]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
+*   `waitForNavigation` **(`"load"` | `"domcontentloaded"` | `"commit"`)?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `commit`. Choose one of those options is possible. See [Playwright API][42].
+*   `pressKeyDelay` **[number][17]?** Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
+*   `getPageTimeout` **[number][17]?** config option to set maximum navigation time in milliseconds.
+*   `waitForTimeout` **[number][17]?** default wait* timeout in ms. Default: 1000.
+*   `basicAuth` **[object][8]?** the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
+*   `windowSize` **[string][7]?** default window size. Set a dimension like `640x480`.
 *   `colorScheme` **(`"dark"` | `"light"` | `"no-preference"`)?** default color scheme. Possible values: `dark` | `light` | `no-preference`.
-*   `userAgent` **[string][9]?** user-agent string.
-*   `locale` **[string][9]?** locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
-*   `manualStart` **[boolean][27]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
-*   `chromium` **[object][6]?** pass additional chromium options
-*   `firefox` **[object][6]?** pass additional firefox options
-*   `electron` **[object][6]?** (pass additional electron options
+*   `userAgent` **[string][7]?** user-agent string.
+*   `locale` **[string][7]?** locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
+*   `manualStart` **[boolean][26]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
+*   `chromium` **[object][8]?** pass additional chromium options
+*   `firefox` **[object][8]?** pass additional firefox options
+*   `electron` **[object][8]?** (pass additional electron options
 *   `channel` **any?** (While Playwright can operate against the stock Google Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels of these browsers. See [Google Chrome & Microsoft Edge][47].
-*   `ignoreLog` **[Array][10]<[string][9]>?** An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values][48].
-*   `ignoreHTTPSErrors` **[boolean][27]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
-*   `bypassCSP` **[boolean][27]?** bypass Content Security Policy or CSP
-*   `highlightElement` **[boolean][27]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
-*   `visibleLocator` **[boolean][27]?** append [`visible()`][49] to locators, so only visible elements are matched. Requires Playwright 1.63 or newer. Switch it off for a single step with `stepOpts({ visibleLocator: false })`. Not applied to `dragAndDrop`, which passes selectors to Playwright directly, nor to steps that must reach hidden elements: `grab*` methods, `scrollTo`, `seeElementInDOM`, `dontSeeElementInDOM` and `seeNumberOfElements`. When enabled, a locator matching only hidden elements fails as "element not found" instead of timing out on actionability, `strict` mode ignores hidden duplicates, and elements hidden by CSS (like a custom checkbox built on a visually hidden `input`) are no longer found.
-*   `recordHar` **[object][6]?** record HAR and will be saved to `output/har`. See more of [HAR options][3].
-*   `testIdAttribute` **[string][9]?** locate elements based on the testIdAttribute. See more of [locate by test id][50].
-*   `storageState` **([string][9] | [object][6])?** Playwright storage state (path to JSON file or object)
+*   `ignoreLog` **[Array][9]<[string][7]>?** An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values][48].
+*   `ignoreHTTPSErrors` **[boolean][26]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
+*   `bypassCSP` **[boolean][26]?** bypass Content Security Policy or CSP
+*   `highlightElement` **[boolean][26]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+*   `visibleLocator` **[boolean][26]?** append [`visible()`][49] to locators, so only visible elements are matched. Requires Playwright 1.63 or newer. Switch it off for a single step with `stepOpts({ visibleLocator: false })`. Not applied to `dragAndDrop`, which passes selectors to Playwright directly, nor to steps that must reach hidden elements: `grab*` methods, `scrollTo`, `seeElementInDOM`, `dontSeeElementInDOM` and `seeNumberOfElements`. When enabled, a locator matching only hidden elements fails as "element not found" instead of timing out on actionability, `strict` mode ignores hidden duplicates, and elements hidden by CSS (like a custom checkbox built on a visually hidden `input`) are no longer found.
+*   `recordHar` **[object][8]?** record HAR and will be saved to `output/har`. See more of [HAR options][3].
+*   `testIdAttribute` **[string][7]?** locate elements based on the testIdAttribute. See more of [locate by test id][50].
+*   `storageState` **([string][7] | [object][8])?** Playwright storage state (path to JSON file or object)
     passed directly to `browser.newContext`.
     If a Scenario is declared with a `cookies` option (e.g. `Scenario('name', { cookies: [...] }, fn)`),
     those cookies are used instead and the configured `storageState` is ignored (no merge).
@@ -292,112 +292,11 @@ await browserContext.cookies(); // get current browser context
 
 *   `config` &#x20;
 
-### _addPopupListener
-
-Add the 'dialog' event listener to a page
-
-#### Parameters
-
-*   `page` &#x20;
-
-### _contextLocator
-
-Grab Locator if called within Context
-
-#### Parameters
-
-*   `locator` **any**&#x20;
-
-### _createContextPage
-
-Create a new browser context with a page. 
-Usually it should be run from a custom helper after call of `_startBrowser()`
-
-#### Parameters
-
-*   `contextOptions` **[object][6]?** See [https://playwright.dev/docs/api/class-browser#browser-new-context][7]
-
-### _getPageUrl
-
-Gets page URL including hash.
-
-### _locate
-
-Get elements by different locator types, including strict locator
-Should be used in custom helpers:
-
-```js
-const elements = await this.helpers['Playwright']._locate({name: 'password'});
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateCheckable
-
-Find a checkbox by providing human-readable text:
-NOTE: Assumes the checkable element exists
-
-```js
-this.helpers['Playwright']._locateCheckable('I agree with terms and conditions').then // ...
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-*   `providedContext`   
-
-### _locateClickable
-
-Find a clickable element by providing human-readable text:
-
-```js
-this.helpers['Playwright']._locateClickable('Next page').then // ...
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateElement
-
-Get the first element by different locator types, including strict locator
-Should be used in custom helpers:
-
-```js
-const element = await this.helpers['Playwright']._locateElement({name: 'password'});
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateFields
-
-Find field elements by providing human-readable text:
-
-```js
-this.helpers['Playwright']._locateFields('Your email').then // ...
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _setPage
-
-Set current page
-
-#### Parameters
-
-*   `page` **[object][6]** page to set
-
 ### acceptPopup
 
 Accepts the active JavaScript native popup window, as created by window.alert|window.confirm|window.prompt.
 Don't confuse popups with modal windows, as created by [various
-libraries][8].
+libraries][6].
 
 ### amAcceptingPopups
 
@@ -434,7 +333,7 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
-*   `url` **[string][9]** url path or global url.
+*   `url` **[string][7]** url path or global url.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -455,9 +354,9 @@ I.appendField('name', 'John', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator
-*   `value` **[string][9]** text value to append.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator
+*   `value` **[string][7]** text value to append.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -485,9 +384,9 @@ I.attachFile('#dropzone', 'data/avatar.jpg');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
-*   `pathToFile` **[string][9]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
+*   `pathToFile` **[string][7]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -510,12 +409,12 @@ I.blockTraffic(['http://example.com/css/style.css', 'http://example.com/css/*.cs
 
 #### Parameters
 
-*   `urls` **([string][9] | [Array][10] | [RegExp][11])** URL or a list of URLs to block . URL can contain * for wildcards. Example: [https://www.example.com][12]** to block all traffic for that domain. Regexp are also supported.
+*   `urls` **([string][7] | [Array][9] | [RegExp][10])** URL or a list of URLs to block . URL can contain * for wildcards. Example: [https://www.example.com][11]** to block all traffic for that domain. Regexp are also supported.
 
 ### blur
 
 Remove focus from a text input, button, etc.
-Calls [blur][13] on the element.
+Calls [blur][12] on the element.
 
 Examples:
 
@@ -532,8 +431,8 @@ I.dontSee('#add-to-cart-btn');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
-*   `options` **any?** Playwright only: [Additional options][14] for available options object as 2nd argument. 
+*   `locator` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
+*   `options` **any?** Playwright only: [Additional options][13] for available options object as 2nd argument. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -543,7 +442,7 @@ Dismisses the active JavaScript popup, as created by window.alert|window.confirm
 
 ### checkOption
 
-[Additional options][15] for check available as 3rd argument.
+[Additional options][14] for check available as 3rd argument.
 
 Examples:
 
@@ -567,12 +466,23 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 *   `options`   
 
 Returns **void** automatically synchronized promise through #recorder
 
+### clearClipboard
+
+Clears the system clipboard.
+
+```js
+I.clearClipboard();
+I.seeClipboardEquals('');
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
 ### clearCookie
 
 Clears a cookie by name,
@@ -586,7 +496,7 @@ I.clearCookie('test');
 #### Parameters
 
 *   `cookieName` &#x20;
-*   `cookie` **[string][9]?** (optional, `null` by default) cookie name 
+*   `cookie` **[string][7]?** (optional, `null` by default) cookie name 
 
 ### clearField
 
@@ -605,8 +515,8 @@ I.clearField('Email', '.form-container');
 #### Parameters
 
 *   `locator` &#x20;
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
-*   `editable` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `editable` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder.
 
@@ -640,13 +550,13 @@ I.click({css: 'nav a.login'});
 I.click({role: 'button', name: 'Submit'});
 ```
 
-> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][16].
+> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][15].
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator. 
-*   `context` **([string][9]? | [object][6] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
-*   `options` **any?** [Additional options][17] for click available as 3rd argument. 
+*   `locator` **([string][7] | [object][8])** (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator. 
+*   `context` **([string][7]? | [object][8] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `options` **any?** [Additional options][16] for click available as 3rd argument. 
 
 #### Examples
 
@@ -678,11 +588,11 @@ I.clickXY('#someElement', 50, 30);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6] | [number][18])** Element to click on or X coordinate if no element.
-*   `x` **[number][18]?** X coordinate relative to element, or Y coordinate if locator is a number.
-*   `y` **[number][18]?** Y coordinate relative to element.
+*   `locator` **([string][7] | [object][8] | [number][17])** Element to click on or X coordinate if no element.
+*   `x` **[number][17]?** X coordinate relative to element, or Y coordinate if locator is a number.
+*   `y` **[number][17]?** Y coordinate relative to element.
 
-Returns **[Promise][19]<void>**&#x20;
+Returns **[Promise][18]<void>**&#x20;
 
 ### closeCurrentTab
 
@@ -712,8 +622,8 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 
 #### Parameters
 
-*   `text` **[string][9]** which is not present.
-*   `context` **([string][9] | [object][6])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
+*   `text` **[string][7]** which is not present.
+*   `context` **([string][7] | [object][8])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -729,7 +639,7 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -743,7 +653,7 @@ I.dontSeeCookie('auth'); // no auth cookie
 
 #### Parameters
 
-*   `name` **[string][9]** cookie name.
+*   `name` **[string][7]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -759,7 +669,7 @@ I.dontSeeCurrentPathEquals('/'); // fails for '/', '/?user=ok', '/#top'
 
 #### Parameters
 
-*   `path` **[string][9]** value to check.
+*   `path` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -775,7 +685,7 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
 
 #### Parameters
 
-*   `url` **[string][9]** value to check.
+*   `url` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -792,8 +702,8 @@ I.dontSeeElement('.modal', '#container');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|Strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|Strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -807,7 +717,7 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|Strict locator.
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|Strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -817,7 +727,7 @@ Checks that current url does not contain a provided fragment.
 
 #### Parameters
 
-*   `url` **[string][9]** value to check.
+*   `url` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -837,9 +747,9 @@ I.dontSeeInField('Name', 'old_value', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][9] | [object][6])** value to check.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][7] | [object][8])** value to check.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -854,7 +764,7 @@ I.dontSeeInSource('<!--'); // no comments in source
 #### Parameters
 
 *   `text` &#x20;
-*   `value` **[string][9]** to check.
+*   `value` **[string][7]** to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -868,7 +778,7 @@ I.dontSeeInTitle('Error');
 
 #### Parameters
 
-*   `text` **[string][9]** value to check.
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -885,10 +795,10 @@ I.dontSeeTraffic({ name: 'Unexpected API Call of "user" endpoint', url: /api.exa
 
 #### Parameters
 
-*   `opts` **[Object][6]** options when checking the traffic network.
+*   `opts` **[Object][8]** options when checking the traffic network.
 
-    *   `opts.name` **[string][9]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
-    *   `opts.url` **([string][9] | [RegExp][11])** Expected URL of request in network traffic. Can be a string or a regular expression.
+    *   `opts.name` **[string][7]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+    *   `opts.url` **([string][7] | [RegExp][10])** Expected URL of request in network traffic. Can be a string or a regular expression.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -906,8 +816,8 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `locator` **([string][7] | [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -928,9 +838,9 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
-*   `srcElement` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `destElement` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `options` **any?** [Additional options][20] can be passed as 3rd argument.
+*   `srcElement` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `destElement` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `options` **any?** [Additional options][19] can be passed as 3rd argument.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -946,8 +856,8 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
-*   `offsetX` **[number][18]** position to drag. 
+*   `locator` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
+*   `offsetX` **[number][17]** position to drag. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -976,10 +886,10 @@ If a function returns a Promise it will wait for its resolution.
 
 #### Parameters
 
-*   `fn` **([string][9] | [function][21])** function to be executed in browser context.
+*   `fn` **([string][7] | [function][20])** function to be executed in browser context.
 *   `arg` **any?** optional argument to pass to the function
 
-Returns **[Promise][19]<any>**&#x20;
+Returns **[Promise][18]<any>**&#x20;
 
 ### fillField
 
@@ -1003,13 +913,13 @@ I.fillField({role: 'textbox', name: 'Email'}, 'hello@world.com');
 I.fillField('Name', 'John', '#section2');
 ```
 
-> ℹ️ ARIA role locators (`{role, name}`) match fields by their accessible name and survive markup refactors. See [Locators][16].
+> ℹ️ ARIA role locators (`{role, name}`) match fields by their accessible name and survive markup refactors. See [Locators][15].
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][9] | [object][6])** text value to fill.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][7] | [object][8])** text value to fill.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1027,7 +937,7 @@ Resets all recorded WS messages.
 
 ### focus
 
-Calls [focus][13] on the matching element.
+Calls [focus][12] on the matching element.
 
 Examples:
 
@@ -1039,8 +949,8 @@ I.see('#add-to-cart-bnt');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
-*   `options` **any?** Playwright only: [Additional options][22] for available options object as 2nd argument. 
+*   `locator` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
+*   `options` **any?** Playwright only: [Additional options][21] for available options object as 2nd argument. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1073,14 +983,14 @@ I.forceClick({css: 'nav a.login'});
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `locator` **([string][7] | [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### grabAriaSnapshot
 
-Retrieves the ARIA snapshot for an element using Playwright's [`locator.ariaSnapshot`][23].
+Retrieves the ARIA snapshot for an element using Playwright's [`locator.ariaSnapshot`][22].
 This method returns a YAML representation of the accessibility tree that can be used for assertions.
 If no locator is provided, it captures the snapshot of the entire page body.
 
@@ -1092,13 +1002,13 @@ const formSnapshot = await I.grabAriaSnapshot('#login-form');
 expect(formSnapshot).toContain('textbox "Email"');
 ```
 
-[Learn more about ARIA snapshots][24]
+[Learn more about ARIA snapshots][23]
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator. Defaults to body element. 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator. Defaults to body element. 
 
-Returns **[Promise][19]<[string][9]>** YAML representation of the accessibility tree
+Returns **[Promise][18]<[string][7]>** YAML representation of the accessibility tree
 
 ### grabAttributeFrom
 
@@ -1112,10 +1022,10 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `attr` **[string][9]** attribute name.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][7]** attribute name.
 
-Returns **[Promise][19]<[string][9]>** attribute value
+Returns **[Promise][18]<[string][7]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -1128,10 +1038,10 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `attr` **[string][9]** attribute name.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][7]** attribute name.
 
-Returns **[Promise][19]<[Array][10]<[string][9]>>** attribute value
+Returns **[Promise][18]<[Array][9]<[string][7]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -1143,9 +1053,9 @@ const errors = logs.map(l => ({ type: l.type(), text: l.text() })).filter(l => l
 console.log(JSON.stringify(errors));
 ```
 
-[Learn more about console messages][25]
+[Learn more about console messages][24]
 
-Returns **[Promise][19]<[Array][10]<any>>**&#x20;
+Returns **[Promise][18]<[Array][9]<any>>**&#x20;
 
 ### grabCheckedElementStatus
 
@@ -1153,10 +1063,10 @@ Return the checked status of given element.
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `options` **[object][6]?** See [https://playwright.dev/docs/api/class-locator#locator-is-checked][26] 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `options` **[object][8]?** See [https://playwright.dev/docs/api/class-locator#locator-is-checked][25] 
 
-Returns **[Promise][19]<[boolean][27]>**&#x20;
+Returns **[Promise][18]<[boolean][26]>**&#x20;
 
 ### grabCookie
 
@@ -1173,7 +1083,7 @@ assert(cookie.value, '123456');
 
 #### Parameters
 
-*   `name` **[string][9]?** cookie name. 
+*   `name` **[string][7]?** cookie name. 
 
 Returns **any** attribute value
 
@@ -1189,10 +1099,10 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `cssProperty` **[string][9]** CSS property name.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][7]** CSS property name.
 
-Returns **[Promise][19]<[string][9]>** CSS value
+Returns **[Promise][18]<[string][7]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -1205,10 +1115,10 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `cssProperty` **[string][9]** CSS property name.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][7]** CSS property name.
 
-Returns **[Promise][19]<[Array][10]<[string][9]>>** CSS value
+Returns **[Promise][18]<[Array][9]<[string][7]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -1220,7 +1130,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][19]<[string][9]>** current URL
+Returns **[Promise][18]<[string][7]>** current URL
 
 ### grabDataFromPerformanceTiming
 
@@ -1253,10 +1163,10 @@ Return the disabled status of given element.
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `options` **[object][6]?** See [https://playwright.dev/docs/api/class-locator#locator-is-disabled][28] 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `options` **[object][8]?** See [https://playwright.dev/docs/api/class-locator#locator-is-disabled][27] 
 
-Returns **[Promise][19]<[boolean][27]>**&#x20;
+Returns **[Promise][18]<[boolean][26]>**&#x20;
 
 ### grabElementBoundingRect
 
@@ -1280,11 +1190,26 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 *   `prop` &#x20;
-*   `elementSize` **[string][9]?** x, y, width or height of the given element.
+*   `elementSize` **[string][7]?** x, y, width or height of the given element.
+
+Returns **([Promise][18]<DOMRect> | [Promise][18]<[number][17]>)** Element bounding rectangle
+
+### grabFromClipboard
+
+Grabs the text content of the system clipboard and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+I.click('Copy to clipboard');
+let url = await I.grabFromClipboard();
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
 
-Returns **([Promise][19]<DOMRect> | [Promise][19]<[number][18]>)** Element bounding rectangle
+Returns **[Promise][18]<[string][7]>** the system clipboard contents.
 
 ### grabHTMLFrom
 
@@ -1299,9 +1224,9 @@ let postHTML = await I.grabHTMLFrom('#post');
 #### Parameters
 
 *   `locator` &#x20;
-*   `element` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
+*   `element` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[string][9]>** HTML code for an element
+Returns **[Promise][18]<[string][7]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -1315,9 +1240,9 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 #### Parameters
 
 *   `locator` &#x20;
-*   `element` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
+*   `element` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[Array][10]<[string][9]>>** HTML code for an element
+Returns **[Promise][18]<[Array][9]<[string][7]>>** HTML code for an element
 
 ### grabMetrics
 
@@ -1372,7 +1297,7 @@ const metrics = await I.grabMetrics();
 
 ```
 
-Returns **[Promise][19]<[Array][10]<[Object][6]>>**&#x20;
+Returns **[Promise][18]<[Array][9]<[Object][8]>>**&#x20;
 
 ### grabNumberOfOpenTabs
 
@@ -1383,7 +1308,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][19]<[number][18]>** number of open tabs
+Returns **[Promise][18]<[number][17]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -1396,9 +1321,9 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[number][18]>** number of visible elements
+Returns **[Promise][18]<[number][17]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -1409,7 +1334,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][19]<PageScrollPosition>** scroll position
+Returns **[Promise][18]<PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -1419,7 +1344,7 @@ Grab the text within the popup. If no popup is visible then it will return null
 await I.grabPopupText();
 ```
 
-Returns **[Promise][19]<([string][9] | null)>**&#x20;
+Returns **[Promise][18]<([string][7] | null)>**&#x20;
 
 ### grabRecordedNetworkTraffics
 
@@ -1432,7 +1357,7 @@ expect(traffics[0].response.status).to.equal(200);
 expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
 ```
 
-Returns **[Array][10]** recorded network traffics
+Returns **[Array][9]** recorded network traffics
 
 ### grabSource
 
@@ -1443,7 +1368,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][19]<[string][9]>** source code
+Returns **[Promise][18]<[string][7]>** source code
 
 ### grabStorageState
 
@@ -1456,9 +1381,9 @@ Avoid committing it to source control and prefer storing it in a protected secre
 
 #### Parameters
 
-*   `options` **[object][6]?**  
+*   `options` **[object][8]?**  
 
-    *   `options.indexedDB` **[boolean][27]?** set to true to include IndexedDB in snapshot (Playwright >=1.51)```js
+    *   `options.indexedDB` **[boolean][26]?** set to true to include IndexedDB in snapshot (Playwright >=1.51)```js
         // basic usage
         const state = await I.grabStorageState();
         require('fs').writeFileSync('authState.json', JSON.stringify(state));
@@ -1480,9 +1405,9 @@ If multiple elements found returns first element.
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[string][9]>** attribute value
+Returns **[Promise][18]<[string][7]>** attribute value
 
 ### grabTextFromAll
 
@@ -1495,9 +1420,9 @@ let pins = await I.grabTextFromAll('#pin li');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[Array][10]<[string][9]>>** attribute value
+Returns **[Promise][18]<[Array][9]<[string][7]>>** attribute value
 
 ### grabTitle
 
@@ -1508,7 +1433,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][19]<[string][9]>** title
+Returns **[Promise][18]<[string][7]>** title
 
 ### grabTrafficUrl
 
@@ -1523,9 +1448,9 @@ I.grabTrafficUrl(/session.*start/);
 
 #### Parameters
 
-*   `urlMatch` **([string][9] | [RegExp][11])** Expected URL of request in network traffic. Can be a string or a regular expression.
+*   `urlMatch` **([string][7] | [RegExp][10])** Expected URL of request in network traffic. Can be a string or a regular expression.
 
-Returns **[Promise][19]<any>**&#x20;
+Returns **[Promise][18]<any>**&#x20;
 
 ### grabValueFrom
 
@@ -1539,9 +1464,9 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[string][9]>** attribute value
+Returns **[Promise][18]<[string][7]>** attribute value
 
 ### grabValueFromAll
 
@@ -1554,9 +1479,9 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][19]<[Array][10]<[string][9]>>** attribute value
+Returns **[Promise][18]<[Array][9]<[string][7]>>** attribute value
 
 ### grabWebElement
 
@@ -1569,9 +1494,9 @@ const webElement = await I.grabWebElement('#button');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<any>** WebElement of being used Web helper
+Returns **[Promise][18]<any>** WebElement of being used Web helper
 
 ### grabWebElements
 
@@ -1584,22 +1509,22 @@ const webElements = await I.grabWebElements('#button');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][19]<any>** WebElement of being used Web helper
+Returns **[Promise][18]<any>** WebElement of being used Web helper
 
 ### grabWebSocketMessages
 
 Grab the recording WS messages
 
-Returns **[Array][10]<any>**&#x20;
+Returns **[Array][9]<any>**&#x20;
 
 ### handleDownloads
 
 Handles a file download. A file name is required to save the file on disk.
 Files are saved to "output" directory.
 
-Should be used with [FileSystem helper][29] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][28] to check that file were downloaded correctly.
 
 ```js
 I.handleDownloads('downloads/avatar.jpg');
@@ -1611,13 +1536,13 @@ I.waitForFile('avatar.jpg', 5);
 
 #### Parameters
 
-*   `fileName` **[string][9]** set filename for downloaded file
+*   `fileName` **[string][7]** set filename for downloaded file
 
-Returns **[Promise][19]<void>**&#x20;
+Returns **[Promise][18]<void>**&#x20;
 
 ### makeApiRequest
 
-Performs [api request][30] using
+Performs [api request][29] using
 the cookies from the current browser session.
 
 ```js
@@ -1630,26 +1555,26 @@ I.makeApiRequest('PATCH', )
 
 #### Parameters
 
-*   `method` **[string][9]** HTTP method
-*   `url` **[string][9]** endpoint
-*   `options` **[object][6]** request options depending on method used
+*   `method` **[string][7]** HTTP method
+*   `url` **[string][7]** endpoint
+*   `options` **[object][8]** request options depending on method used
 
-Returns **[Promise][19]<[object][6]>** response
+Returns **[Promise][18]<[object][8]>** response
 
 ### mockRoute
 
-Mocks network request using [`browserContext.route`][31] of Playwright
+Mocks network request using [`browserContext.route`][30] of Playwright
 
 ```js
 I.mockRoute(/(.png$)|(.jpg$)/, route => route.abort());
 ```
 
-This method allows intercepting and mocking requests & responses. [Learn more about it][32]
+This method allows intercepting and mocking requests & responses. [Learn more about it][31]
 
 #### Parameters
 
-*   `url` **([string][9] | [RegExp][11])?** URL, regex or pattern for to match URL
-*   `handler` **[function][21]?** a function to process request
+*   `url` **([string][7] | [RegExp][10])?** URL, regex or pattern for to match URL
+*   `handler` **[function][20]?** a function to process request
 
 ### mockTraffic
 
@@ -1686,9 +1611,9 @@ I.moveCursorTo('#submit', '.container');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `offsetX` **([number][18] | [string][9] | [object][6])** (optional, `0` by default) X-axis offset or context locator. 
-*   `offsetY` **[number][18]** (optional, `0` by default) Y-axis offset. 
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `offsetX` **([number][17] | [string][7] | [object][8])** (optional, `0` by default) X-axis offset or context locator. 
+*   `offsetY` **[number][17]** (optional, `0` by default) Y-axis offset. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1700,7 +1625,7 @@ Open new tab and automatically switched to new tab
 I.openNewTab();
 ```
 
-You can pass in [page options][33] to emulate device on this page
+You can pass in [page options][32] to emulate device on this page
 
 ```js
 // enable mobile
@@ -1713,11 +1638,11 @@ I.openNewTab({ isMobile: true });
 
 ### pressKey
 
-*Note:* Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313][34]).
+*Note:* Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313][33]).
 
 Presses a key in the browser (on a focused element).
 
-*Hint:* For populating text field or textarea, it is recommended to use [`fillField`][35].
+*Hint:* For populating text field or textarea, it is recommended to use [`fillField`][34].
 
 ```js
 I.pressKey('Backspace');
@@ -1776,7 +1701,7 @@ Some of the supported key names are:
 
 #### Parameters
 
-*   `key` **([string][9] | [Array][10]<[string][9]>)** key or array of keys to press.
+*   `key` **([string][7] | [Array][9]<[string][7]>)** key or array of keys to press.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1784,7 +1709,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Presses a key in the browser and leaves it in a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][36]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][35]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1794,7 +1719,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
-*   `key` **[string][9]** name of key to press down.
+*   `key` **[string][7]** name of key to press down.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1802,7 +1727,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Releases a key in the browser which was previously set to a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][36]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][35]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1812,7 +1737,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
-*   `key` **[string][9]** name of key to release.
+*   `key` **[string][7]** name of key to release.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1841,8 +1766,8 @@ Replaying from HAR
 
 #### Parameters
 
-*   `harFilePath` **[string][9]** Path to recorded HAR file
-*   `opts` **[object][6]?** [Options for replaying from HAR][37]
+*   `harFilePath` **[string][7]** Path to recorded HAR file
+*   `opts` **[object][8]?** [Options for replaying from HAR][36]
 
 Returns **any** Promise<void>
 
@@ -1865,8 +1790,8 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
-*   `width` **[number][18]** width in pixels or `maximize`.
-*   `height` **[number][18]** height in pixels.
+*   `width` **[number][17]** width in pixels or `maximize`.
+*   `height` **[number][17]** height in pixels.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1885,8 +1810,8 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** clickable element located by CSS|XPath|strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+*   `locator` **([string][7] | [object][8])** clickable element located by CSS|XPath|strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1901,8 +1826,8 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `fileName` **[string][9]** file name to save.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `fileName` **[string][7]** file name to save.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1919,8 +1844,8 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 
 #### Parameters
 
-*   `fileName` **[string][9]** file name to save.
-*   `fullPage` **[boolean][27]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+*   `fileName` **[string][7]** file name to save.
+*   `fullPage` **[boolean][26]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1956,9 +1881,9 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `offsetX` **[number][18]** (optional, `0` by default) X-axis offset. 
-*   `offsetY` **[number][18]** (optional, `0` by default) Y-axis offset. 
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `offsetX` **[number][17]** (optional, `0` by default) X-axis offset. 
+*   `offsetY` **[number][17]** (optional, `0` by default) Y-axis offset. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1975,8 +1900,8 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
-*   `text` **[string][9]** expected on page.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
+*   `text` **[string][7]** expected on page.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1990,8 +1915,8 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `attributes` **[object][6]** attributes and their values to check.
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `attributes` **[object][8]** attributes and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2007,7 +1932,25 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeClipboardEquals
+
+Checks that the system clipboard is equal to the given text.
+
+```js
+I.click('Copy to clipboard');
+I.seeClipboardEquals('https://codecept.io');
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
+
+#### Parameters
+
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2021,7 +1964,7 @@ I.seeCookie('Auth');
 
 #### Parameters
 
-*   `name` **[string][9]** cookie name.
+*   `name` **[string][7]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2035,8 +1978,8 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `cssProperties` **[object][6]** object with CSS properties and their values to check.
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `cssProperties` **[object][8]** object with CSS properties and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2052,7 +1995,7 @@ I.seeCurrentPathEquals('/'); // passes for '/', '/?user=ok', '/#top'
 
 #### Parameters
 
-*   `path` **[string][9]** value to check.
+*   `path` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2069,7 +2012,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 #### Parameters
 
-*   `url` **[string][9]** value to check.
+*   `url` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2087,12 +2030,12 @@ I.seeElement('#modal', '#container');
 I.seeElement({role: 'dialog'});
 ```
 
-> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][16].
+> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][15].
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** located by CSS|XPath|strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][7] | [object][8])** located by CSS|XPath|strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2107,7 +2050,25 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInClipboard
+
+Checks that the system clipboard contains the given text.
+
+```js
+I.click('Copy to clipboard');
+I.seeInClipboard('https://codecept.io');
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
+
+#### Parameters
+
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2121,7 +2082,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 #### Parameters
 
-*   `url` **[string][9]** a fragment to check
+*   `url` **[string][7]** a fragment to check
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2143,9 +2104,9 @@ I.seeInField('Name', 'John', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][9] | [object][6])** value to check.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][7] | [object][8])** value to check.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2160,7 +2121,7 @@ I.seeInPopup('Popup text');
 
 #### Parameters
 
-*   `text` **[string][9]** value to check.
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2174,7 +2135,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
-*   `text` **[string][9]** value to check.
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2188,7 +2149,7 @@ I.seeInTitle('Home Page');
 
 #### Parameters
 
-*   `text` **[string][9]** text value to check.
+*   `text` **[string][7]** text value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2203,8 +2164,8 @@ I.seeNumberOfElements('#submitBtn', 1);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `num` **[number][18]** number of elements.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `num` **[number][17]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2219,8 +2180,8 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `num` **[number][18]** number of elements.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `num` **[number][17]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2234,8 +2195,8 @@ I.seeTextEquals('text', 'h1');
 
 #### Parameters
 
-*   `text` **[string][9]** element value to check.
-*   `context` **([string][9] | [object][6])?** element located by CSS|XPath|strict locator. 
+*   `text` **[string][7]** element value to check.
+*   `context` **([string][7] | [object][8])?** element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2249,7 +2210,7 @@ I.seeTitleEquals('Test title.');
 
 #### Parameters
 
-*   `text` **[string][9]** value to check.
+*   `text` **[string][7]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2286,13 +2247,13 @@ await I.seeTraffic({
 
 #### Parameters
 
-*   `opts` **[Object][6]** options when checking the traffic network.
+*   `opts` **[Object][8]** options when checking the traffic network.
 
-    *   `opts.name` **[string][9]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
-    *   `opts.url` **[string][9]** Expected URL of request in network traffic
-    *   `opts.parameters` **[Object][6]?** Expected parameters of that request in network traffic
-    *   `opts.requestPostData` **[Object][6]?** Expected that request contains post data in network traffic
-    *   `opts.timeout` **[number][18]?** Timeout to wait for request in seconds. Default is 10 seconds. 
+    *   `opts.name` **[string][7]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+    *   `opts.url` **[string][7]** Expected URL of request in network traffic
+    *   `opts.parameters` **[Object][8]?** Expected parameters of that request in network traffic
+    *   `opts.requestPostData` **[Object][8]?** Expected that request contains post data in network traffic
+    *   `opts.timeout` **[number][17]?** Timeout to wait for request in seconds. Default is 10 seconds. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2323,9 +2284,9 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
-*   `select` **([string][9] | [object][6])** field located by label|name|CSS|XPath|strict locator.
-*   `option` **([string][9] | [Array][10]<any>)** visible text or value of option.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `select` **([string][7] | [object][8])** field located by label|name|CSS|XPath|strict locator.
+*   `option` **([string][7] | [Array][9]<any>)** visible text or value of option.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2347,7 +2308,7 @@ I.setCookie([
 
 #### Parameters
 
-*   `cookie` **(Cookie | [Array][10]<Cookie>)** a cookie object or array of cookie objects.
+*   `cookie` **(Cookie | [Array][9]<Cookie>)** a cookie object or array of cookie objects.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2363,7 +2324,7 @@ I.setPlaywrightRequestHeaders({
 
 #### Parameters
 
-*   `customHeaders` **[object][6]** headers to set
+*   `customHeaders` **[object][8]** headers to set
 
 ### startRecordingTraffic
 
@@ -2400,8 +2361,8 @@ If no handler is passed, all mock requests for the rote are disabled.
 
 #### Parameters
 
-*   `url` **([string][9] | [RegExp][11])?** URL, regex or pattern for to match URL
-*   `handler` **[function][21]?** a function to process request
+*   `url` **([string][7] | [RegExp][10])?** URL, regex or pattern for to match URL
+*   `handler` **[function][20]?** a function to process request
 
 ### stopRecordingTraffic
 
@@ -2432,7 +2393,7 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
-*   `locator` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+*   `locator` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2447,7 +2408,7 @@ I.switchToNextTab(2);
 
 #### Parameters
 
-*   `num` **[number][18]**  
+*   `num` **[number][17]**  
 
 ### switchToPreviousTab
 
@@ -2460,13 +2421,13 @@ I.switchToPreviousTab(2);
 
 #### Parameters
 
-*   `num` **[number][18]**  
+*   `num` **[number][17]**  
 
 ### type
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-*Note:* Should be used when [`fillField`][35] is not an option.
+*Note:* Should be used when [`fillField`][34] is not an option.
 
 ```js
 // passing in a string
@@ -2485,14 +2446,14 @@ I.type(secret('123456'));
 #### Parameters
 
 *   `keys` &#x20;
-*   `delay` **[number][18]?** (optional) delay in ms between key presses 
-*   `key` **([string][9] | [Array][10]<[string][9]>)** or array of keys to type.
+*   `delay` **[number][17]?** (optional) delay in ms between key presses 
+*   `key` **([string][7] | [Array][9]<[string][7]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### uncheckOption
 
-[Additional options][38] for uncheck available as 3rd argument.
+[Additional options][37] for uncheck available as 3rd argument.
 
 Examples:
 
@@ -2516,8 +2477,8 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
-*   `context` **([string][9]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][7] | [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][7]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 *   `options`   
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2529,7 +2490,7 @@ Use Playwright API inside a test.
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`page`][39], [`browserContext`][40] [`browser`][41] } objects from Playwright API are available.
+{ [`page`][38], [`browserContext`][39] [`browser`][40] } objects from Playwright API are available.
 
 ```js
 I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
@@ -2539,8 +2500,8 @@ I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
 
 #### Parameters
 
-*   `description` **[string][9]** used to show in logs.
-*   `fn` **[function][21]** async function that executed with Playwright helper as arguments
+*   `description` **[string][7]** used to show in logs.
+*   `fn` **[function][20]** async function that executed with Playwright helper as arguments
 
 ### wait
 
@@ -2552,7 +2513,7 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
-*   `sec` **[number][18]** number of second to wait.
+*   `sec` **[number][17]** number of second to wait.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2577,9 +2538,9 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
 *   `waitTimeout` &#x20;
-*   `sec` **[number][18]?** (optional, `1` by default) time in seconds to wait
+*   `sec` **[number][17]?** (optional, `1` by default) time in seconds to wait
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2593,8 +2554,8 @@ I.waitForCookie("token");
 
 #### Parameters
 
-*   `name` **[string][9]** expected cookie name.
-*   `sec` **[number][18]** (optional, `3` by default) time in seconds to wait 
+*   `name` **[string][7]** expected cookie name.
+*   `sec` **[number][17]** (optional, `3` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2609,8 +2570,8 @@ I.waitForDetached('#popup');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2621,8 +2582,8 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional) time in seconds to wait, 1 by default. 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional) time in seconds to wait, 1 by default. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2638,8 +2599,8 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]?** (optional, `1` by default) time in seconds to wait
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]?** (optional, `1` by default) time in seconds to wait
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2650,8 +2611,8 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional) time in seconds to wait, 1 by default. 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional) time in seconds to wait, 1 by default. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2672,9 +2633,9 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
-*   `fn` **([string][9] | [function][21])** to be executed in browser context.
-*   `argsOrSec` **([Array][10]<any> | [number][18])?** (optional, `1` by default) arguments for function or seconds. 
-*   `sec` **[number][18]?** (optional, `1` by default) time in seconds to wait 
+*   `fn` **([string][7] | [function][20])** to be executed in browser context.
+*   `argsOrSec` **([Array][9]<any> | [number][17])?** (optional, `1` by default) arguments for function or seconds. 
+*   `sec` **[number][17]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2689,8 +2650,8 @@ I.waitForInvisible('#popup');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2698,7 +2659,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Waits for navigation to finish. By default, it takes configured `waitForNavigation` option.
 
-See [Playwright's reference][42]
+See [Playwright's reference][41]
 
 #### Parameters
 
@@ -2714,8 +2675,8 @@ I.waitForNumberOfTabs(2);
 
 #### Parameters
 
-*   `expectedTabs` **[number][18]** expecting the number of tabs.
-*   `sec` **[number][18]** number of secs to wait.
+*   `expectedTabs` **[number][17]** expecting the number of tabs.
+*   `sec` **[number][17]** number of secs to wait.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2730,8 +2691,8 @@ I.waitForRequest(request => request.url() === 'http://example.com' && request.me
 
 #### Parameters
 
-*   `urlOrPredicate` **([string][9] | [function][21])**&#x20;
-*   `sec` **[number][18]?** seconds to wait 
+*   `urlOrPredicate` **([string][7] | [function][20])**&#x20;
+*   `sec` **[number][17]?** seconds to wait 
 
 ### waitForResponse
 
@@ -2744,8 +2705,8 @@ I.waitForResponse(response => response.url() === 'https://example.com' && respon
 
 #### Parameters
 
-*   `urlOrPredicate` **([string][9] | [function][21])**&#x20;
-*   `sec` **[number][18]?** number of seconds to wait 
+*   `urlOrPredicate` **([string][7] | [function][20])**&#x20;
+*   `sec` **[number][17]?** number of seconds to wait 
 
 ### waitForText
 
@@ -2760,9 +2721,9 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
-*   `text` **[string][9]** to wait for.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
-*   `context` **([string][9] | [object][6])?** (optional) element located by CSS|XPath|strict locator. 
+*   `text` **[string][7]** to wait for.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
+*   `context` **([string][7] | [object][8])?** (optional) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2770,11 +2731,11 @@ Returns **void** automatically synchronized promise through #recorder
 
 Waits for page navigates to a new URL or reloads. By default, it takes configured `waitForNavigation` option.
 
-See [Playwright's reference][43]
+See [Playwright's reference][42]
 
 #### Parameters
 
-*   `url` **([string][9] | [RegExp][11])** A glob pattern, regex pattern or predicate receiving URL to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string.
+*   `url` **([string][7] | [RegExp][10])** A glob pattern, regex pattern or predicate receiving URL to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string.
 *   `options` **any**  
 
 ### waitForValue
@@ -2787,9 +2748,9 @@ I.waitForValue('//input', "GoodValue");
 
 #### Parameters
 
-*   `field` **([string][9] | [object][6])** input field.
-*   `value` **[string][9]** expected value.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `field` **([string][7] | [object][8])** input field.
+*   `value` **[string][7]** expected value.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2804,8 +2765,8 @@ I.waitForVisible('#popup');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2819,8 +2780,8 @@ I.waitInUrl('/info', 2);
 
 #### Parameters
 
-*   `urlPart` **[string][9]** value to check.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `urlPart` **[string][7]** value to check.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2834,9 +2795,9 @@ I.waitNumberOfVisibleElements('a', 3);
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `num` **[number][18]** number of elements.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `num` **[number][17]** number of elements.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2851,8 +2812,8 @@ I.waitToHide('#popup');
 
 #### Parameters
 
-*   `locator` **([string][9] | [object][6])** element located by CSS|XPath|strict locator.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `locator` **([string][7] | [object][8])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2867,11 +2828,112 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 #### Parameters
 
-*   `urlPart` **[string][9]** value to check.
-*   `sec` **[number][18]** (optional, `1` by default) time in seconds to wait 
+*   `urlPart` **[string][7]** value to check.
+*   `sec` **[number][17]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
+### _addPopupListener
+
+Add the 'dialog' event listener to a page
+
+#### Parameters
+
+*   `page` &#x20;
+
+### _contextLocator
+
+Grab Locator if called within Context
+
+#### Parameters
+
+*   `locator` **any**&#x20;
+
+### _createContextPage
+
+Create a new browser context with a page. 
+Usually it should be run from a custom helper after call of `_startBrowser()`
+
+#### Parameters
+
+*   `contextOptions` **[object][8]?** See [https://playwright.dev/docs/api/class-browser#browser-new-context][43]
+
+### _getPageUrl
+
+Gets page URL including hash.
+
+### _locate
+
+Get elements by different locator types, including strict locator
+Should be used in custom helpers:
+
+```js
+const elements = await this.helpers['Playwright']._locate({name: 'password'});
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateCheckable
+
+Find a checkbox by providing human-readable text:
+NOTE: Assumes the checkable element exists
+
+```js
+this.helpers['Playwright']._locateCheckable('I agree with terms and conditions').then // ...
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+*   `providedContext`   
+
+### _locateClickable
+
+Find a clickable element by providing human-readable text:
+
+```js
+this.helpers['Playwright']._locateClickable('Next page').then // ...
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateElement
+
+Get the first element by different locator types, including strict locator
+Should be used in custom helpers:
+
+```js
+const element = await this.helpers['Playwright']._locateElement({name: 'password'});
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateFields
+
+Find field elements by providing human-readable text:
+
+```js
+this.helpers['Playwright']._locateFields('Your email').then // ...
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _setPage
+
+Set current page
+
+#### Parameters
+
+*   `page` **[object][8]** page to set
+
 [1]: https://github.com/microsoft/playwright
 
 [2]: https://playwright.dev/docs/next/api/class-browser#browser-new-context
@@ -2882,81 +2944,81 @@ Returns **void** automatically synchronized promise through #recorder
 
 [5]: https://github.com/microsoft/playwright/blob/v0.11.0/docs/api.md#working-with-chrome-extensions
 
-[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[6]: http://jster.net/category/windows-modals-popups
 
-[7]: https://playwright.dev/docs/api/class-browser#browser-new-context
+[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[8]: http://jster.net/category/windows-modals-popups
+[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
 
-[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
 
-[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+[11]: https://www.example.com
 
-[12]: https://www.example.com
+[12]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
 
-[13]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
+[13]: https://playwright.dev/docs/api/class-locator#locator-blur
 
-[14]: https://playwright.dev/docs/api/class-locator#locator-blur
+[14]: https://playwright.dev/docs/api/class-elementhandle#element-handle-check
 
-[15]: https://playwright.dev/docs/api/class-elementhandle#element-handle-check
+[15]: /locators#aria-locators
 
-[16]: /locators#aria-locators
+[16]: https://playwright.dev/docs/api/class-page#page-click
 
-[17]: https://playwright.dev/docs/api/class-page#page-click
+[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[19]: https://playwright.dev/docs/api/class-page#page-drag-and-drop
 
-[20]: https://playwright.dev/docs/api/class-page#page-drag-and-drop
+[20]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[21]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[21]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[22]: https://playwright.dev/docs/api/class-locator#locator-focus
+[22]: https://playwright.dev/docs/api/class-locator#locator-aria-snapshot
 
-[23]: https://playwright.dev/docs/api/class-locator#locator-aria-snapshot
+[23]: https://playwright.dev/docs/aria-snapshots
 
-[24]: https://playwright.dev/docs/aria-snapshots
+[24]: https://playwright.dev/docs/api/class-consolemessage
 
-[25]: https://playwright.dev/docs/api/class-consolemessage
+[25]: https://playwright.dev/docs/api/class-locator#locator-is-checked
 
-[26]: https://playwright.dev/docs/api/class-locator#locator-is-checked
+[26]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[27]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[27]: https://playwright.dev/docs/api/class-locator#locator-is-disabled
 
-[28]: https://playwright.dev/docs/api/class-locator#locator-is-disabled
+[28]: https://codecept.io/helpers/FileSystem
 
-[29]: https://codecept.io/helpers/FileSystem
+[29]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
 
-[30]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
+[30]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
 
-[31]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
+[31]: https://playwright.dev/docs/network#handle-requests
 
-[32]: https://playwright.dev/docs/network#handle-requests
+[32]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
 
-[33]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
+[33]: https://github.com/puppeteer/puppeteer/issues/1313
 
-[34]: https://github.com/puppeteer/puppeteer/issues/1313
+[34]: #fillfield
 
-[35]: #fillfield
+[35]: #click
 
-[36]: #click
+[36]: https://playwright.dev/docs/api/class-page#page-route-from-har
 
-[37]: https://playwright.dev/docs/api/class-page#page-route-from-har
+[37]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
 
-[38]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
+[38]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
 
-[39]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
+[39]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
 
-[40]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
+[40]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
 
-[41]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
+[41]: https://playwright.dev/docs/api/class-page#page-wait-for-navigation
 
-[42]: https://playwright.dev/docs/api/class-page#page-wait-for-navigation
+[42]: https://playwright.dev/docs/api/class-page#page-wait-for-url
 
-[43]: https://playwright.dev/docs/api/class-page#page-wait-for-url
+[43]: https://playwright.dev/docs/api/class-browser#browser-new-context
 
 [44]: https://playwright.dev/docs/api/class-browsercontext