codeceptjs 3.4.1 → 3.5.1

package/docs/helpers/Puppeteer.md

@@ -39,23 +39,24 @@ Type: [object][4]
 
 -   `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'}
--   `show` **[boolean][17]?** show Google Chrome window for debug.
--   `restart` **[boolean][17]?** restart browser between tests.
--   `disableScreenshots` **[boolean][17]?** don't save screenshot on failure.
--   `fullPageScreenshots` **[boolean][17]?** make full page screenshots on failure.
--   `uniqueScreenshotNames` **[boolean][17]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
--   `keepBrowserState` **[boolean][17]?** keep browser state between tests when `restart` is set to false.
--   `keepCookies` **[boolean][17]?** keep cookies between tests when `restart` is set to false.
--   `waitForAction` **[number][8]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
--   `waitForNavigation` **[string][6]?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][20]. Array values are accepted as well.
--   `pressKeyDelay` **[number][8]?** delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
--   `getPageTimeout` **[number][8]?** config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
--   `waitForTimeout` **[number][8]?** default wait* timeout in ms.
+-   `show` **[boolean][20]?** show Google Chrome window for debug.
+-   `restart` **[boolean][20]?** restart browser between tests.
+-   `disableScreenshots` **[boolean][20]?** don't save screenshot on failure.
+-   `fullPageScreenshots` **[boolean][20]?** make full page screenshots on failure.
+-   `uniqueScreenshotNames` **[boolean][20]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+-   `keepBrowserState` **[boolean][20]?** keep browser state between tests when `restart` is set to false.
+-   `keepCookies` **[boolean][20]?** keep cookies between tests when `restart` is set to false.
+-   `waitForAction` **[number][10]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
+-   `waitForNavigation` **[string][6]?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][23]. Array values are accepted as well.
+-   `pressKeyDelay` **[number][10]?** delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
+-   `getPageTimeout` **[number][10]?** config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
+-   `waitForTimeout` **[number][10]?** 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.
--   `manualStart` **[boolean][17]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
+-   `manualStart` **[boolean][20]?** 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][22].
+-   `chrome` **[object][4]?** pass additional [Puppeteer run options][25].
+-   `highlightElement` **[boolean][20]?** highlight the interacting elements
 
 
 
@@ -296,6 +297,8 @@ Field is located by name, label, CSS or XPath
 
 ```js
 I.appendField('#myTextField', 'appended');
+// typing secret
+I.appendField('password', secret('123456'));
 ```
 
 #### Parameters
@@ -325,6 +328,29 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 -   `pathToFile` **[string][6]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
     ⚠️ returns a _promise_ which is synchronized internally by recorder> ⚠ There is an [issue with file upload in Puppeteer 2.1.0 & 2.1.1][7], downgrade to 2.0.0 if you face it.
 
+### blur
+
+Remove focus from a text input, button, etc.
+Calls [blur][8] on the element.
+
+Examples:
+
+```js
+I.blur('.text-area')
+```
+
+```js
+//element `#product-tile` is focused
+I.see('#add-to-cart-btn');
+I.blur('#product-tile')
+I.dontSee('#add-to-cart-btn');
+```
+
+#### Parameters
+
+-   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+-   `options` **any?** Playwright only: [Additional options][9] for available options object as 2nd argument.
+
 ### cancelPopup
 
 Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
@@ -653,7 +679,7 @@ I.dragSlider('#slider', -70);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
--   `offsetX` **[number][8]** position to drag.
+-   `offsetX` **[number][10]** position to drag.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -665,7 +691,7 @@ This action supports [React locators](https://codecept.io/react#locators)
 Executes async script on page.
 Provided function should execute a passed callback (as first argument) to signal it is finished.
 
-Example: In Vue.js to make components completely rendered we are waiting for [nextTick][9].
+Example: In Vue.js to make components completely rendered we are waiting for [nextTick][11].
 
 ```js
 I.executeAsyncScript(function(done) {
@@ -687,7 +713,7 @@ let val = await I.executeAsyncScript(function(url, done) {
 
 -   `args` **...any** to be passed to function.
     ⚠️ returns a _promise_ which is synchronized internally by recorderAsynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
--   `fn` **([string][6] | [function][10])** function to be executed in browser context.
+-   `fn` **([string][6] | [function][12])** function to be executed in browser context.
 
 ### executeScript
 
@@ -719,7 +745,7 @@ let date = await I.executeScript(function(el) {
 
 -   `args` **...any** to be passed to function.
     ⚠️ returns a _promise_ which is synchronized internally by recorderIf a function returns a Promise It will wait for it resolution.
--   `fn` **([string][6] | [function][10])** function to be executed in browser context.
+-   `fn` **([string][6] | [function][12])** function to be executed in browser context.
 
 ### fillField
 
@@ -747,6 +773,23 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 This action supports [React locators](https://codecept.io/react#locators)
 
 
+### focus
+
+Calls [focus][8] on the matching element.
+
+Examples:
+
+```js
+I.dontSee('#add-to-cart-btn');
+I.focus('#product-tile')
+I.see('#add-to-cart-bnt');
+```
+
+#### Parameters
+
+-   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+-   `options` **any?** Playwright only: [Additional options][13] for available options object as 2nd argument.
+
 ### forceClick
 
 Perform an emulated click on a link or a button, given by a locator.
@@ -799,7 +842,7 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][6]** attribute name.
 
-Returns **[Promise][11]<[string][6]>** attribute value
+Returns **[Promise][14]<[string][6]>** attribute value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -819,7 +862,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][6]** attribute name.
 
-Returns **[Promise][11]<[Array][12]<[string][6]>>** attribute value
+Returns **[Promise][14]<[Array][15]<[string][6]>>** attribute value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -834,7 +877,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **[Promise][11]<[Array][12]<any>>** 
+Returns **[Promise][14]<[Array][15]<any>>** 
 
 ### grabCookie
 
@@ -851,7 +894,7 @@ assert(cookie.value, '123456');
 
 -   `name` **[string][6]?** cookie name. 
 
-Returns **([Promise][11]<[string][6]> | [Promise][11]<[Array][12]<[string][6]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
+Returns **([Promise][14]<[string][6]> | [Promise][14]<[Array][15]<[string][6]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
 
 ### grabCssPropertyFrom
 
@@ -868,7 +911,7 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][6]** CSS property name.
 
-Returns **[Promise][11]<[string][6]>** CSS value
+Returns **[Promise][14]<[string][6]>** CSS value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -888,7 +931,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][6]** CSS property name.
 
-Returns **[Promise][11]<[Array][12]<[string][6]>>** CSS value
+Returns **[Promise][14]<[Array][15]<[string][6]>>** CSS value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -904,7 +947,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][11]<[string][6]>** current URL
+Returns **[Promise][14]<[string][6]>** current URL
 
 ### grabDataFromPerformanceTiming
 
@@ -929,7 +972,7 @@ let data = await I.grabDataFromPerformanceTiming();
 }
 ```
 
-Returns **[Promise][11]<any>** automatically synchronized promise through #recorder
+Returns **[Promise][14]<any>** automatically synchronized promise through #recorder
 
 ### grabElementBoundingRect
 
@@ -957,7 +1000,7 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 -   `prop`  
 -   `elementSize` **[string][6]?** x, y, width or height of the given element.
 
-Returns **([Promise][11]<DOMRect> | [Promise][11]<[number][8]>)** Element bounding rectangle
+Returns **([Promise][14]<DOMRect> | [Promise][14]<[number][10]>)** Element bounding rectangle
 
 ### grabHTMLFrom
 
@@ -974,7 +1017,7 @@ let postHTML = await I.grabHTMLFrom('#post');
 -   `locator`  
 -   `element` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[string][6]>** HTML code for an element
+Returns **[Promise][14]<[string][6]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -990,7 +1033,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 -   `locator`  
 -   `element` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[Array][12]<[string][6]>>** HTML code for an element
+Returns **[Promise][14]<[Array][15]<[string][6]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -1001,7 +1044,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][11]<[number][8]>** number of open tabs
+Returns **[Promise][14]<[number][10]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -1016,7 +1059,7 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 -   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[number][8]>** number of visible elements
+Returns **[Promise][14]<[number][10]>** number of visible elements
 
 
 
@@ -1032,7 +1075,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][11]<PageScrollPosition>** scroll position
+Returns **[Promise][14]<PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -1042,7 +1085,7 @@ Grab the text within the popup. If no popup is visible then it will return null
 await I.grabPopupText();
 ```
 
-Returns **[Promise][11]<([string][6] | null)>** 
+Returns **[Promise][14]<([string][6] | null)>** 
 
 ### grabSource
 
@@ -1053,7 +1096,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][11]<[string][6]>** source code
+Returns **[Promise][14]<[string][6]>** source code
 
 ### grabTextFrom
 
@@ -1070,7 +1113,7 @@ If multiple elements found returns first element.
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[string][6]>** attribute value
+Returns **[Promise][14]<[string][6]>** attribute value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -1089,7 +1132,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[Array][12]<[string][6]>>** attribute value
+Returns **[Promise][14]<[Array][15]<[string][6]>>** attribute value
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -1104,7 +1147,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][11]<[string][6]>** title
+Returns **[Promise][14]<[string][6]>** title
 
 ### grabValueFrom
 
@@ -1120,7 +1163,7 @@ let email = await I.grabValueFrom('input[name=email]');
 
 -   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[string][6]>** attribute value
+Returns **[Promise][14]<[string][6]>** attribute value
 
 ### grabValueFromAll
 
@@ -1135,12 +1178,12 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 -   `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][11]<[Array][12]<[string][6]>>** attribute value
+Returns **[Promise][14]<[Array][15]<[string][6]>>** attribute value
 
 ### handleDownloads
 
 Sets a directory to where save files. Allows to test file downloads.
-Should be used with [FileSystem helper][13] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][16] to check that file were downloaded correctly.
 
 By default files are saved to `output/downloads`.
 This directory is cleaned on every `handleDownloads` call, to ensure no old files are kept.
@@ -1183,8 +1226,8 @@ I.moveCursorTo('#submit', 5,5);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
--   `offsetX` **[number][8]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset.
+-   `offsetX` **[number][10]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -1203,7 +1246,7 @@ I.openNewTab();
 
 Presses a key in the browser (on a focused element).
 
-_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][14].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][17].
 
 ```js
 I.pressKey('Backspace');
@@ -1262,14 +1305,14 @@ Some of the supported key names are:
 
 #### Parameters
 
--   `key` **([string][6] | [Array][12]<[string][6]>)** key or array of keys to press.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313][15]).
+-   `key` **([string][6] | [Array][15]<[string][6]>)** key or array of keys to press.
+    ⚠️ returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313][18]).
 
 ### pressKeyDown
 
 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`][16]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][19]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1286,7 +1329,7 @@ I.pressKeyUp('Control');
 
 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`][16]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][19]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1316,8 +1359,8 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
--   `width` **[number][8]** width in pixels or `maximize`.
--   `height` **[number][8]** height in pixels.
+-   `width` **[number][10]** width in pixels or `maximize`.
+-   `height` **[number][10]** height in pixels.
     ⚠️ returns a _promise_ which is synchronized internally by recorderUnlike other drivers Puppeteer changes the size of a viewport, not the window!
     Puppeteer does not control the window of a browser so it can't adjust its real size.
     It also can't maximize a window.
@@ -1374,7 +1417,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 -   `fileName` **[string][6]** file name to save.
--   `fullPage` **[boolean][17]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
+-   `fullPage` **[boolean][20]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### scrollPageToBottom
@@ -1410,8 +1453,8 @@ I.scrollTo('#submit', 5, 5);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
--   `offsetX` **[number][8]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset.
+-   `offsetX` **[number][10]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### see
@@ -1630,7 +1673,7 @@ I.seeNumberOfElements('#submitBtn', 1);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `num` **[number][8]** number of elements.
+-   `num` **[number][10]** number of elements.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -1649,7 +1692,7 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `num` **[number][8]** number of elements.
+-   `num` **[number][10]** number of elements.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -1707,7 +1750,7 @@ 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][12]<any>)** visible text or value of option.
+-   `option` **([string][6] | [Array][15]<any>)** visible text or value of option.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### setCookie
@@ -1728,7 +1771,7 @@ I.setCookie([
 
 #### Parameters
 
--   `cookie` **(Cookie | [Array][12]<Cookie>)** a cookie object or array of cookie objects.
+-   `cookie` **(Cookie | [Array][15]<Cookie>)** a cookie object or array of cookie objects.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### switchTo
@@ -1756,7 +1799,7 @@ I.switchToNextTab(2);
 
 #### Parameters
 
--   `num` **[number][8]**  
+-   `num` **[number][10]**  
 
 ### switchToPreviousTab
 
@@ -1769,13 +1812,13 @@ I.switchToPreviousTab(2);
 
 #### Parameters
 
--   `num` **[number][8]**  
+-   `num` **[number][10]**  
 
 ### 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`][14] is not an option.
+_Note:_ Should be used when [`fillField`][17] is not an option.
 
 ```js
 // passing in a string
@@ -1786,14 +1829,17 @@ I.type('4141555311111111', 100);
 
 // passing in an array
 I.type(['T', 'E', 'X', 'T']);
+
+// passing a secret
+I.type(secret('123456'));
 ```
 
 #### Parameters
 
 -   `keys`  
--   `delay` **[number][8]?** (optional) delay in ms between key presses
+-   `delay` **[number][10]?** (optional) delay in ms between key presses
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
--   `key` **([string][6] | [Array][12]<[string][6]>)** or array of keys to type.
+-   `key` **([string][6] | [Array][15]<[string][6]>)** or array of keys to type.
 
 ### uncheckOption
 
@@ -1821,7 +1867,7 @@ Use Puppeteer API inside a test.
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`page`][18], [`browser`][19] } from Puppeteer API are available.
+{ [`page`][21], [`browser`][22] } from Puppeteer API are available.
 
 ```js
 I.usePuppeteerTo('emulate offline mode', async ({ page }) {
@@ -1832,7 +1878,7 @@ I.usePuppeteerTo('emulate offline mode', async ({ page }) {
 #### Parameters
 
 -   `description` **[string][6]** used to show in logs.
--   `fn` **[function][10]** async function that is executed with Puppeteer as argument
+-   `fn` **[function][12]** async function that is executed with Puppeteer as argument
 
 ### wait
 
@@ -1844,7 +1890,7 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
--   `sec` **[number][8]** number of second to wait.
+-   `sec` **[number][10]** number of second to wait.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### waitForClickable
@@ -1861,7 +1907,7 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
 -   `waitTimeout`  
--   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### waitForDetached
@@ -1876,7 +1922,7 @@ I.waitForDetached('#popup');
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForElement
@@ -1892,7 +1938,7 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -1907,7 +1953,7 @@ Element can be located by CSS or XPath.
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]** (optional) time in seconds to wait, 1 by default.
+-   `sec` **[number][10]** (optional) time in seconds to wait, 1 by default.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForFunction
@@ -1927,9 +1973,9 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][6] | [function][10])** to be executed in browser context.
--   `argsOrSec` **([Array][12]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
--   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
+-   `fn` **([string][6] | [function][12])** to be executed in browser context.
+-   `argsOrSec` **([Array][15]<any> | [number][10])?** (optional, `1` by default) arguments for function or seconds. 
+-   `sec` **[number][10]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForInvisible
@@ -1944,14 +1990,14 @@ I.waitForInvisible('#popup');
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForNavigation
 
 Waits for navigation to finish. By default takes configured `waitForNavigation` option.
 
-See [Pupeteer's reference][20]
+See [Pupeteer's reference][23]
 
 #### Parameters
 
@@ -1968,8 +2014,8 @@ I.waitForRequest(request => request.url() === 'http://example.com' && request.me
 
 #### Parameters
 
--   `urlOrPredicate` **([string][6] | [function][10])** 
--   `sec` **[number][8]?** seconds to wait 
+-   `urlOrPredicate` **([string][6] | [function][12])** 
+-   `sec` **[number][10]?** seconds to wait 
 
 ### waitForResponse
 
@@ -1982,8 +2028,8 @@ I.waitForResponse(response => response.url() === 'http://example.com' && respons
 
 #### Parameters
 
--   `urlOrPredicate` **([string][6] | [function][10])** 
--   `sec` **[number][8]?** number of seconds to wait 
+-   `urlOrPredicate` **([string][6] | [function][12])** 
+-   `sec` **[number][10]?** number of seconds to wait 
 
 ### waitForText
 
@@ -1999,7 +2045,7 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 #### Parameters
 
 -   `text` **[string][6]** to wait for.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait 
 -   `context` **([string][6] | [object][4])?** (optional) element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
@@ -2015,7 +2061,7 @@ I.waitForValue('//input', "GoodValue");
 
 -   `field` **([string][6] | [object][4])** input field.
 -   `value` **[string][6]** expected value.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForVisible
@@ -2030,8 +2076,8 @@ I.waitForVisible('#popup');
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][21]. 
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
+    ⚠️ returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][24]. 
 
 ### waitInUrl
 
@@ -2044,7 +2090,7 @@ I.waitInUrl('/info', 2);
 #### Parameters
 
 -   `urlPart` **[string][6]** value to check.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitNumberOfVisibleElements
@@ -2058,8 +2104,8 @@ I.waitNumberOfVisibleElements('a', 3);
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `num` **[number][8]** number of elements.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `num` **[number][10]** number of elements.
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 
@@ -2078,7 +2124,7 @@ I.waitToHide('#popup');
 #### Parameters
 
 -   `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitUrlEquals
@@ -2093,7 +2139,7 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 #### Parameters
 
 -   `urlPart` **[string][6]** value to check.
--   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 [1]: https://github.com/GoogleChrome/puppeteer
@@ -2110,32 +2156,38 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [7]: https://github.com/puppeteer/puppeteer/issues/5420
 
-[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[8]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
+
+[9]: https://playwright.dev/docs/api/class-locator#locator-blur
+
+[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+
+[11]: https://vuejs.org/v2/api/#Vue-nextTick
 
-[9]: https://vuejs.org/v2/api/#Vue-nextTick
+[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[13]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[13]: https://codecept.io/helpers/FileSystem
+[16]: https://codecept.io/helpers/FileSystem
 
-[14]: #fillfield
+[17]: #fillfield
 
-[15]: https://github.com/GoogleChrome/puppeteer/issues/1313
+[18]: https://github.com/GoogleChrome/puppeteer/issues/1313
 
-[16]: #click
+[19]: #click
 
-[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[20]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[18]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-page
+[21]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-page
 
-[19]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-browser
+[22]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-browser
 
-[20]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions
+[23]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions
 
-[21]: https://codecept.io/react
+[24]: https://codecept.io/react
 
-[22]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions
+[25]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions