codeceptjs 4.2.0-beta.4 → 4.2.1-beta.1

package/docs/helpers/Puppeteer.md

@@ -33,12 +33,12 @@ Using `puppeteer-core` package, will prevent the download of browser binaries an
 
 This helper should be configured in codecept.conf.js
 
-Type: [object][4]
+Type: [object][6]
 
 ### Properties
 
-*   `url` **[string][6]** base url of website to be tested
-*   `basicAuth` **[object][4]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
+*   `url` **[string][5]** base url of website to be tested
+*   `basicAuth` **[object][6]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
 *   `show` **[boolean][24]?** show Google Chrome window for debug.
 *   `restart` **[boolean][24]?** restart browser between tests.
 *   `disableScreenshots` **[boolean][24]?** don't save screenshot on failure.
@@ -49,15 +49,15 @@ Type: [object][4]
 *   `keepBrowserState` **[boolean][24]?** keep browser state between tests when `restart` is set to false.
 *   `keepCookies` **[boolean][24]?** keep cookies between tests when `restart` is set to false.
 *   `waitForAction` **[number][11]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-*   `waitForNavigation` **([string][6] | [Array][17]<[string][6]>)?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][29]. Array values are accepted as well.
+*   `waitForNavigation` **([string][5] | [Array][17]<[string][5]>)?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][29]. Array values are accepted as well.
 *   `pressKeyDelay` **[number][11]?** delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
 *   `getPageTimeout` **[number][11]?** config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
 *   `waitForTimeout` **[number][11]?** default wait* timeout in ms.
-*   `windowSize` **[string][6]?** default window size. Set a dimension in format WIDTHxHEIGHT like `640x480`.
-*   `userAgent` **[string][6]?** user-agent string.
+*   `windowSize` **[string][5]?** default window size. Set a dimension in format WIDTHxHEIGHT like `640x480`.
+*   `userAgent` **[string][5]?** user-agent string.
 *   `manualStart` **[boolean][24]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
-*   `browser` **[string][6]?** can be changed to `firefox` when using [puppeteer-firefox][2].
-*   `chrome` **[object][4]?** pass additional [Puppeteer run options][30].
+*   `browser` **[string][5]?** can be changed to `firefox` when using [puppeteer-firefox][2].
+*   `chrome` **[object][6]?** pass additional [Puppeteer run options][30].
 *   `highlightElement` **[boolean][24]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
 
 ## findElement
@@ -67,10 +67,10 @@ Note: Puppeteer Locator API doesn't have .first() method like Playwright
 
 ### Parameters
 
-*   `matcher` **[Object][4]** Puppeteer context to search within
-*   `locator` **([Object][4] | [string][6])** Locator specification
+*   `matcher` **[Object][6]** Puppeteer context to search within
+*   `locator` **([Object][6] | [string][5])** Locator specification
 
-Returns **[Promise][12]<[Object][4]>** Single ElementHandle object
+Returns **[Promise][12]<[Object][6]>** Single ElementHandle object
 
 ## findElements
 
@@ -79,8 +79,8 @@ Note: Unlike Playwright, Puppeteer's Locator API doesn't have .all() method for
 
 ### Parameters
 
-*   `matcher` **[Object][4]** Puppeteer context to search within
-*   `locator` **([Object][4] | [string][6])** Locator specification
+*   `matcher` **[Object][6]** Puppeteer context to search within
+*   `locator` **([Object][6] | [string][5])** Locator specification
 
 Returns **[Promise][12]<[Array][17]>** Array of ElementHandle objects
 
@@ -211,95 +211,11 @@ await page.url(); // Get the url of the current page
 
 *   `config` &#x20;
 
-### _addPopupListener
-
-Add the 'dialog' event listener to a page
-
-#### Parameters
-
-*   `page` &#x20;
-
-### _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['Puppeteer']._locate({name: 'password'});
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateCheckable
-
-Find a checkbox by providing human-readable text:
-NOTE: Assumes the checkable element exists
-
-```js
-this.helpers['Puppeteer']._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['Puppeteer']._locateClickable('Next page').then // ...
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateElement
-
-Get single element by different locator types, including strict locator
-Should be used in custom helpers:
-
-```js
-const element = await this.helpers['Puppeteer']._locateElement({name: 'password'});
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _locateFields
-
-Find field elements by providing human-readable text:
-
-```js
-this.helpers['Puppeteer']._locateFields('Your email').then // ...
-```
-
-#### Parameters
-
-*   `locator` &#x20;
-
-### _setPage
-
-Set current page
-
-#### Parameters
-
-*   `page` **[object][4]** 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][5].
+libraries][4].
 
 ### amAcceptingPopups
 
@@ -336,7 +252,7 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
-*   `url` **[string][6]** url path or global url.
+*   `url` **[string][5]** url path or global url.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -357,9 +273,9 @@ I.appendField('name', 'John', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator
-*   `value` **[string][6]** text value to append.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator
+*   `value` **[string][5]** text value to append.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -389,9 +305,9 @@ I.attachFile('#dropzone', 'data/avatar.jpg');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
-*   `pathToFile` **[string][6]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
+*   `pathToFile` **[string][5]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -415,7 +331,7 @@ I.dontSee('#add-to-cart-btn');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 *   `options` **any?** Playwright only: [Additional options][9] for available options object as 2nd argument.
 
 Returns **void** automatically synchronized promise through #recorder
@@ -439,8 +355,19 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### clearClipboard
+
+Clears the system clipboard.
+
+```js
+I.clearClipboard();
+I.seeClipboardEquals('');
+```
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -457,7 +384,7 @@ I.clearCookie('test');
 #### Parameters
 
 *   `name` &#x20;
-*   `cookie` **[string][6]?** (optional, `null` by default) cookie name 
+*   `cookie` **[string][5]?** (optional, `null` by default) cookie name 
 
 ### clearField
 
@@ -476,8 +403,8 @@ I.clearField('Email', '.form-container');
 #### Parameters
 
 *   `field` &#x20;
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
-*   `editable` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `editable` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder.
 
@@ -515,8 +442,8 @@ I.click({role: 'button', name: 'Submit'});
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator. 
-*   `context` **([string][6]? | [object][4] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `locator` **([string][5] | [object][6])** (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator. 
+*   `context` **([string][5]? | [object][6] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -530,8 +457,8 @@ I.clickLink('Logout', '#nav');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator 
+*   `locator` **([string][5] | [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -551,7 +478,7 @@ I.clickXY('#someElement', 50, 30);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4] | [number][11])** Element to click on or X coordinate if no element.
+*   `locator` **([string][5] | [object][6] | [number][11])** Element to click on or X coordinate if no element.
 *   `x` **[number][11]?** X coordinate relative to element, or Y coordinate if locator is a number.
 *   `y` **[number][11]?** Y coordinate relative to element.
 
@@ -585,8 +512,8 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 
 #### Parameters
 
-*   `text` **[string][6]** which is not present.
-*   `context` **([string][6] | [object][4])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
+*   `text` **[string][5]** which is not present.
+*   `context` **([string][5] | [object][6])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -602,7 +529,7 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `field` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -616,7 +543,7 @@ I.dontSeeCookie('auth'); // no auth cookie
 
 #### Parameters
 
-*   `name` **[string][6]** cookie name.
+*   `name` **[string][5]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -632,7 +559,7 @@ I.dontSeeCurrentPathEquals('/'); // fails for '/', '/?user=ok', '/#top'
 
 #### Parameters
 
-*   `path` **[string][6]** value to check.
+*   `path` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -648,7 +575,7 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
 
 #### Parameters
 
-*   `url` **[string][6]** value to check.
+*   `url` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -665,8 +592,8 @@ I.dontSeeElement('.modal', '#container');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|Strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|Strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -680,7 +607,7 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|Strict locator.
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|Strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -690,7 +617,7 @@ Checks that current url does not contain a provided fragment.
 
 #### Parameters
 
-*   `url` **[string][6]** value to check.
+*   `url` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -710,9 +637,9 @@ I.dontSeeInField('Name', 'old_value', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][6] | [object][4])** value to check.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][5] | [object][6])** value to check.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -727,7 +654,7 @@ I.dontSeeInSource('<!--'); // no comments in source
 #### Parameters
 
 *   `text` &#x20;
-*   `value` **[string][6]** to check.
+*   `value` **[string][5]** to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -741,7 +668,7 @@ I.dontSeeInTitle('Error');
 
 #### Parameters
 
-*   `text` **[string][6]** value to check.
+*   `text` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -758,10 +685,10 @@ I.dontSeeTraffic({ name: 'Unexpected API Call of "user" endpoint', url: /api.exa
 
 #### Parameters
 
-*   `opts` **[Object][4]** options when checking the traffic network.
+*   `opts` **[Object][6]** options when checking the traffic network.
 
-    *   `opts.name` **[string][6]** 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][6] | [RegExp][13])** Expected URL of request in network traffic. Can be a string or a regular expression.
+    *   `opts.name` **[string][5]** 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][5] | [RegExp][13])** Expected URL of request in network traffic. Can be a string or a regular expression.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -779,8 +706,8 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `locator` **([string][5] | [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -805,8 +732,8 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
-*   `srcElement` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
-*   `destElement` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
+*   `srcElement` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
+*   `destElement` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -822,7 +749,7 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator.
 *   `offsetX` **[number][11]** position to drag. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -854,7 +781,7 @@ let val = await I.executeAsyncScript(function(url, done) {
 #### Parameters
 
 *   `args` **...any** to be passed to function.
-*   `fn` **([string][6] | [function][15])** function to be executed in browser context.
+*   `fn` **([string][5] | [function][15])** function to be executed in browser context.
 
 Returns **[Promise][12]<any>** script return value
 
@@ -889,7 +816,7 @@ let date = await I.executeScript(function(el) {
 #### Parameters
 
 *   `args` **...any** to be passed to function.
-*   `fn` **([string][6] | [function][15])** function to be executed in browser context.
+*   `fn` **([string][5] | [function][15])** function to be executed in browser context.
 
 Returns **[Promise][12]<any>** script return value
 
@@ -919,9 +846,9 @@ I.fillField('Name', 'John', '#section2');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][6] | [object][4])** text value to fill.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][5] | [object][6])** text value to fill.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -951,7 +878,7 @@ I.see('#add-to-cart-bnt');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 *   `options` **any?** Playwright only: [Additional options][16] for available options object as 2nd argument.
 
 Returns **void** automatically synchronized promise through #recorder
@@ -985,8 +912,8 @@ I.forceClick({css: 'nav a.login'});
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+*   `locator` **([string][5] | [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1002,10 +929,10 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
-*   `attr` **[string][6]** attribute name.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][5]** attribute name.
 
-Returns **[Promise][12]<[string][6]>** attribute value
+Returns **[Promise][12]<[string][5]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -1018,10 +945,10 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
-*   `attr` **[string][6]** attribute name.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][5]** attribute name.
 
-Returns **[Promise][12]<[Array][17]<[string][6]>>** attribute value
+Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -1047,7 +974,7 @@ assert(cookie.value, '123456');
 
 #### Parameters
 
-*   `name` **[string][6]?** cookie name. 
+*   `name` **[string][5]?** cookie name. 
 
 Returns **any** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
 
@@ -1063,10 +990,10 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
-*   `cssProperty` **[string][6]** CSS property name.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][5]** CSS property name.
 
-Returns **[Promise][12]<[string][6]>** CSS value
+Returns **[Promise][12]<[string][5]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -1079,10 +1006,10 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
-*   `cssProperty` **[string][6]** CSS property name.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][5]** CSS property name.
 
-Returns **[Promise][12]<[Array][17]<[string][6]>>** CSS value
+Returns **[Promise][12]<[Array][17]<[string][5]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -1094,7 +1021,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][12]<[string][6]>** current URL
+Returns **[Promise][12]<[string][5]>** current URL
 
 ### grabDataFromPerformanceTiming
 
@@ -1143,12 +1070,27 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `prop` &#x20;
-*   `elementSize` **[string][6]?** x, y, width or height of the given element.
+*   `elementSize` **[string][5]?** x, y, width or height of the given element.
 
 Returns **([Promise][12]<DOMRect> | [Promise][12]<[number][11]>)** 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][12]<[string][5]>** the system clipboard contents.
+
 ### grabHTMLFrom
 
 Retrieves the innerHTML from an element located by CSS or XPath and returns it to test.
@@ -1162,9 +1104,9 @@ let postHTML = await I.grabHTMLFrom('#post');
 #### Parameters
 
 *   `locator` &#x20;
-*   `element` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
+*   `element` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[string][6]>** HTML code for an element
+Returns **[Promise][12]<[string][5]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -1178,9 +1120,9 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 #### Parameters
 
 *   `locator` &#x20;
-*   `element` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
+*   `element` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][6]>>** HTML code for an element
+Returns **[Promise][12]<[Array][17]<[string][5]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -1204,7 +1146,7 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 
 Returns **[Promise][12]<[number][11]>** number of visible elements
 
@@ -1227,7 +1169,7 @@ Grab the text within the popup. If no popup is visible then it will return null
 await I.grabPopupText();
 ```
 
-Returns **[Promise][12]<([string][6] | null)>**&#x20;
+Returns **[Promise][12]<([string][5] | null)>**&#x20;
 
 ### grabRecordedNetworkTraffics
 
@@ -1251,7 +1193,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][12]<[string][6]>** source code
+Returns **[Promise][12]<[string][5]>** source code
 
 ### grabTextFrom
 
@@ -1266,9 +1208,9 @@ If multiple elements found returns first element.
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[string][6]>** attribute value
+Returns **[Promise][12]<[string][5]>** attribute value
 
 ### grabTextFromAll
 
@@ -1281,9 +1223,9 @@ let pins = await I.grabTextFromAll('#pin li');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][6]>>** attribute value
+Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
 
 ### grabTitle
 
@@ -1294,7 +1236,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][12]<[string][6]>** title
+Returns **[Promise][12]<[string][5]>** title
 
 ### grabValueFrom
 
@@ -1308,9 +1250,9 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[string][6]>** attribute value
+Returns **[Promise][12]<[string][5]>** attribute value
 
 ### grabValueFromAll
 
@@ -1323,9 +1265,9 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][6]>>** attribute value
+Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
 
 ### grabWebElement
 
@@ -1338,7 +1280,7 @@ const webElement = await I.grabWebElement('#button');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 
 Returns **[Promise][12]<any>** WebElement of being used Web helper
 
@@ -1353,7 +1295,7 @@ const webElements = await I.grabWebElements('#button');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 
 Returns **[Promise][12]<any>** WebElement of being used Web helper
 
@@ -1381,7 +1323,7 @@ I.seeFile('avatar.jpg');
 
 #### Parameters
 
-*   `downloadPath` **[string][6]** change this parameter to set another directory for saving 
+*   `downloadPath` **[string][5]** change this parameter to set another directory for saving 
 
 ### mockRoute
 
@@ -1395,7 +1337,7 @@ This method allows intercepting and mocking requests & responses. [Learn more ab
 
 #### Parameters
 
-*   `url` **([string][6] | [RegExp][13])?** URL, regex or pattern for to match URL
+*   `url` **([string][5] | [RegExp][13])?** URL, regex or pattern for to match URL
 *   `handler` **[function][15]?** a function to process request
 
 ### moveCursorTo
@@ -1414,8 +1356,8 @@ I.moveCursorTo('#submit', '.container');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
-*   `offsetX` **([number][11] | [string][6] | [object][4])** (optional, `0` by default) X-axis offset or context locator. 
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
+*   `offsetX` **([number][11] | [string][5] | [object][6])** (optional, `0` by default) X-axis offset or context locator. 
 *   `offsetY` **[number][11]** (optional, `0` by default) Y-axis offset. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1493,7 +1435,7 @@ Some of the supported key names are:
 
 #### Parameters
 
-*   `key` **([string][6] | [Array][17]<[string][6]>)** key or array of keys to press.
+*   `key` **([string][5] | [Array][17]<[string][5]>)** key or array of keys to press.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1511,7 +1453,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
-*   `key` **[string][6]** name of key to press down.
+*   `key` **[string][5]** name of key to press down.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1529,7 +1471,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
-*   `key` **[string][6]** name of key to release.
+*   `key` **[string][5]** name of key to release.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1574,8 +1516,8 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** clickable element located by CSS|XPath|strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+*   `locator` **([string][5] | [object][6])** clickable element located by CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1590,8 +1532,8 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
-*   `fileName` **[string][6]** file name to save.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
+*   `fileName` **[string][5]** file name to save.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1608,7 +1550,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 
 #### Parameters
 
-*   `fileName` **[string][6]** file name to save.
+*   `fileName` **[string][5]** file name to save.
 *   `fullPage` **[boolean][24]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1645,7 +1587,7 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 *   `offsetX` **[number][11]** (optional, `0` by default) X-axis offset. 
 *   `offsetY` **[number][11]** (optional, `0` by default) Y-axis offset. 
 
@@ -1664,8 +1606,8 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
-*   `text` **[string][6]** expected on page.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
+*   `text` **[string][5]** expected on page.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1679,8 +1621,8 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
-*   `attributes` **[object][4]** attributes and their values to check.
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
+*   `attributes` **[object][6]** attributes and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1696,7 +1638,25 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `field` **([string][5] | [object][6])** 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][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1710,7 +1670,7 @@ I.seeCookie('Auth');
 
 #### Parameters
 
-*   `name` **[string][6]** cookie name.
+*   `name` **[string][5]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1724,8 +1684,8 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
-*   `cssProperties` **[object][4]** object with CSS properties and their values to check.
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
+*   `cssProperties` **[object][6]** object with CSS properties and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1741,7 +1701,7 @@ I.seeCurrentPathEquals('/'); // passes for '/', '/?user=ok', '/#top'
 
 #### Parameters
 
-*   `path` **[string][6]** value to check.
+*   `path` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1758,7 +1718,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 #### Parameters
 
-*   `url` **[string][6]** value to check.
+*   `url` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1780,8 +1740,8 @@ I.seeElement({role: 'dialog'});
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1796,7 +1756,25 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** 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][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1810,7 +1788,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 #### Parameters
 
-*   `url` **[string][6]** a fragment to check
+*   `url` **[string][5]** a fragment to check
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1832,9 +1810,9 @@ I.seeInField('Name', 'John', '.form-container');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
-*   `value` **([string][6] | [object][4])** value to check.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][5] | [object][6])** value to check.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1849,7 +1827,7 @@ I.seeInPopup('Popup text');
 
 #### Parameters
 
-*   `text` **[string][6]** value to check.
+*   `text` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1863,7 +1841,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
-*   `text` **[string][6]** value to check.
+*   `text` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1877,7 +1855,7 @@ I.seeInTitle('Home Page');
 
 #### Parameters
 
-*   `text` **[string][6]** text value to check.
+*   `text` **[string][5]** text value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1892,7 +1870,7 @@ I.seeNumberOfElements('#submitBtn', 1);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `num` **[number][11]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1908,7 +1886,7 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `num` **[number][11]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1923,8 +1901,8 @@ I.seeTextEquals('text', 'h1');
 
 #### Parameters
 
-*   `text` **[string][6]** element value to check.
-*   `context` **([string][6] | [object][4])?** element located by CSS|XPath|strict locator. 
+*   `text` **[string][5]** element value to check.
+*   `context` **([string][5] | [object][6])?** element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1938,7 +1916,7 @@ I.seeTitleEquals('Test title.');
 
 #### Parameters
 
-*   `text` **[string][6]** value to check.
+*   `text` **[string][5]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1975,12 +1953,12 @@ await I.seeTraffic({
 
 #### Parameters
 
-*   `opts` **[Object][4]** options when checking the traffic network.
+*   `opts` **[Object][6]** options when checking the traffic network.
 
-    *   `opts.name` **[string][6]** 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][6]** Expected URL of request in network traffic
-    *   `opts.parameters` **[Object][4]?** Expected parameters of that request in network traffic
-    *   `opts.requestPostData` **[Object][4]?** Expected that request contains post data in network traffic
+    *   `opts.name` **[string][5]** 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][5]** 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][11]?** Timeout to wait for request in seconds. Default is 10 seconds. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2012,9 +1990,9 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
-*   `select` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
-*   `option` **([string][6] | [Array][17]<any>)** visible text or value of option.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `select` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
+*   `option` **([string][5] | [Array][17]<any>)** visible text or value of option.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2052,7 +2030,7 @@ I.setPuppeteerRequestHeaders({
 
 #### Parameters
 
-*   `customHeaders` **[object][4]** headers to set
+*   `customHeaders` **[object][6]** headers to set
 
 ### startRecordingTraffic
 
@@ -2086,7 +2064,7 @@ I.stopMockingRoute(/(.png$)|(.jpg$)/);
 
 #### Parameters
 
-*   `url` **([string][6] | [RegExp][13])?** URL, regex or pattern for to match URL
+*   `url` **([string][5] | [RegExp][13])?** URL, regex or pattern for to match URL
 
 ### stopRecordingTraffic
 
@@ -2117,7 +2095,7 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
-*   `locator` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+*   `locator` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2171,7 +2149,7 @@ I.type(secret('123456'));
 
 *   `keys` &#x20;
 *   `delay` **[number][11]?** (optional) delay in ms between key presses 
-*   `key` **([string][6] | [Array][17]<[string][6]>)** or array of keys to type.
+*   `key` **([string][5] | [Array][17]<[string][5]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2190,8 +2168,8 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
-*   `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `field` **([string][5] | [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2212,7 +2190,7 @@ I.usePuppeteerTo('emulate offline mode', async ({ page }) {
 
 #### Parameters
 
-*   `description` **[string][6]** used to show in logs.
+*   `description` **[string][5]** used to show in logs.
 *   `fn` **[function][15]** async function that is executed with Puppeteer as argument
 
 ### wait
@@ -2250,7 +2228,7 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `waitTimeout` &#x20;
 *   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
 
@@ -2266,7 +2244,7 @@ I.waitForCookie("token");
 
 #### Parameters
 
-*   `name` **[string][6]** expected cookie name.
+*   `name` **[string][5]** expected cookie name.
 *   `sec` **[number][11]** (optional, `3` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2282,7 +2260,7 @@ I.waitForDetached('#popup');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2299,7 +2277,7 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2311,7 +2289,7 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]** (optional) time in seconds to wait, 1 by default. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2333,7 +2311,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
-*   `fn` **([string][6] | [function][15])** to be executed in browser context.
+*   `fn` **([string][5] | [function][15])** to be executed in browser context.
 *   `argsOrSec` **([Array][17]<any> | [number][11])?** (optional, `1` by default) arguments for function or seconds. 
 *   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait 
 
@@ -2350,7 +2328,7 @@ I.waitForInvisible('#popup');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2391,7 +2369,7 @@ I.waitForRequest(request => request.url() === 'http://example.com' && request.me
 
 #### Parameters
 
-*   `urlOrPredicate` **([string][6] | [function][15])**&#x20;
+*   `urlOrPredicate` **([string][5] | [function][15])**&#x20;
 *   `sec` **[number][11]?** seconds to wait 
 
 ### waitForResponse
@@ -2405,7 +2383,7 @@ I.waitForResponse(response => response.url() === 'http://example.com' && respons
 
 #### Parameters
 
-*   `urlOrPredicate` **([string][6] | [function][15])**&#x20;
+*   `urlOrPredicate` **([string][5] | [function][15])**&#x20;
 *   `sec` **[number][11]?** number of seconds to wait 
 
 ### waitForText
@@ -2421,9 +2399,9 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
-*   `text` **[string][6]** to wait for.
+*   `text` **[string][5]** to wait for.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
-*   `context` **([string][6] | [object][4])?** (optional) element located by CSS|XPath|strict locator. 
+*   `context` **([string][5] | [object][6])?** (optional) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2437,8 +2415,8 @@ I.waitForValue('//input', "GoodValue");
 
 #### Parameters
 
-*   `field` **([string][6] | [object][4])** input field.
-*   `value` **[string][6]** expected value.
+*   `field` **([string][5] | [object][6])** input field.
+*   `value` **[string][5]** expected value.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2454,7 +2432,7 @@ I.waitForVisible('#popup');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2469,7 +2447,7 @@ I.waitInUrl('/info', 2);
 
 #### Parameters
 
-*   `urlPart` **[string][6]** value to check.
+*   `urlPart` **[string][5]** value to check.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2484,7 +2462,7 @@ I.waitNumberOfVisibleElements('a', 3);
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `num` **[number][11]** number of elements.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
@@ -2501,7 +2479,7 @@ I.waitToHide('#popup');
 
 #### Parameters
 
-*   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2517,22 +2495,106 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 #### Parameters
 
-*   `urlPart` **[string][6]** value to check.
+*   `urlPart` **[string][5]** value to check.
 *   `sec` **[number][11]** (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;
+
+### _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['Puppeteer']._locate({name: 'password'});
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateCheckable
+
+Find a checkbox by providing human-readable text:
+NOTE: Assumes the checkable element exists
+
+```js
+this.helpers['Puppeteer']._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['Puppeteer']._locateClickable('Next page').then // ...
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateElement
+
+Get single element by different locator types, including strict locator
+Should be used in custom helpers:
+
+```js
+const element = await this.helpers['Puppeteer']._locateElement({name: 'password'});
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _locateFields
+
+Find field elements by providing human-readable text:
+
+```js
+this.helpers['Puppeteer']._locateFields('Your email').then // ...
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+
+### _setPage
+
+Set current page
+
+#### Parameters
+
+*   `page` **[object][6]** page to set
+
 [1]: https://github.com/puppeteer/puppeteer
 
 [2]: https://codecept.io/helpers/Puppeteer-firefox
 
 [3]: https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target
 
-[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[4]: http://jster.net/category/windows-modals-popups
 
-[5]: http://jster.net/category/windows-modals-popups
+[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
 
 [7]: https://github.com/puppeteer/puppeteer/issues/5420