codeceptjs 3.3.6 → 3.3.7

package/docs/helpers/Playwright.md

@@ -39,36 +39,39 @@ Type: [object][5]
 
 ### Properties
 
--   `url` **[string][7]** base url of website to be tested
--   `browser` **[string][7]** a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
--   `show` **[boolean][25]?** show browser window.
--   `restart` **([string][7] | [boolean][25])?** restart strategy between tests. Possible values:-   'context' or **false** - restarts [browser context][32] but keeps running browser. Recommended by Playwright team to keep tests isolated.
+-   `url` **[string][8]** base url of website to be tested
+-   `browser` **[string][8]?** a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
+-   `show` **[boolean][26]?** show browser window.
+-   `restart` **([string][8] | [boolean][26])?** restart strategy between tests. Possible values:-   'context' or **false** - restarts [browser context][33] but keeps running browser. Recommended by Playwright team to keep tests isolated.
     -   'browser' or **true** - closes browser and opens it again between tests.
     -   '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][11]?** -   [timeout][33] in ms of all Playwright actions .
--   `disableScreenshots` **[boolean][25]?** don't save screenshot on failure.
+-   `timeout` **[number][12]?** -   [timeout][34] in ms of all Playwright actions .
+-   `disableScreenshots` **[boolean][26]?** don't save screenshot on failure.
 -   `emulate` **any?** browser in device emulation mode.
--   `video` **[boolean][25]?** enables video recording for failed tests; videos are saved into `output/videos` folder
--   `keepVideoForPassedTests` **[boolean][25]?** save videos for passed tests; videos are saved into `output/videos` folder
--   `trace` **[boolean][25]?** record [tracing information][34] with screenshots and snapshots.
--   `fullPageScreenshots` **[boolean][25]?** make full page screenshots on failure.
--   `uniqueScreenshotNames` **[boolean][25]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
--   `keepBrowserState` **[boolean][25]?** keep browser state between tests when `restart` is set to 'session'.
--   `keepCookies` **[boolean][25]?** keep cookies between tests when `restart` is set to 'session'.
--   `waitForAction` **[number][11]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
--   `waitForNavigation` **[string][7]?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API][35].
--   `pressKeyDelay` **[number][11]?** Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
--   `getPageTimeout` **[number][11]?** config option to set maximum navigation time in milliseconds.
--   `waitForTimeout` **[number][11]?** default wait* timeout in ms. Default: 1000.
+-   `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][35] with screenshots and snapshots.
+-   `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][12]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
+-   `waitForNavigation` **[string][8]?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API][36].
+-   `pressKeyDelay` **[number][12]?** Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
+-   `getPageTimeout` **[number][12]?** config option to set maximum navigation time in milliseconds.
+-   `waitForTimeout` **[number][12]?** default wait* timeout in ms. Default: 1000.
 -   `basicAuth` **[object][5]?** 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` **[string][7]?** default color scheme. Possible values: `dark` | `light` | `no-preference`.
--   `userAgent` **[string][7]?** user-agent string.
--   `locale` **[string][7]?** locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
--   `manualStart` **[boolean][25]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
+-   `windowSize` **[string][8]?** default window size. Set a dimension like `640x480`.
+-   `colorScheme` **[string][8]?** default color scheme. Possible values: `dark` | `light` | `no-preference`.
+-   `userAgent` **[string][8]?** user-agent string.
+-   `locale` **[string][8]?** 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][5]?** pass additional chromium options
+-   `firefox` **[object][5]?** pass additional firefox options
 -   `electron` **[object][5]?** (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][36].
+-   `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][37].
+-   `ignoreLog` **[Array][15]<[string][8]>?** 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][38].
+-   `ignoreHTTPSErrors` **[boolean][26]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
 
 
 
@@ -249,6 +252,15 @@ Grab Locator if called within Context
 
 -   `locator` **any** 
 
+### _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][5]?** See [https://playwright.dev/docs/api/class-browser#browser-new-context][6]
+
 ### _getPageUrl
 
 Gets page URL including hash.
@@ -316,7 +328,7 @@ Set current page
 
 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][6].
+libraries][7].
 
 ### amAcceptingPopups
 
@@ -353,7 +365,7 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
--   `url` **[string][7]** url path or global url.
+-   `url` **[string][8]** url path or global url.
 
 Returns **void** automatically synchronized promise with recorder #!
 
@@ -368,8 +380,8 @@ I.appendField('#myTextField', 'appended');
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator
--   `value` **[string][7]** text value to append.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator
+-   `value` **[string][8]** text value to append.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### attachFile
@@ -385,8 +397,8 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** 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.
+-   `locator` **([string][8] | [object][5])** field located by label|name|CSS|XPath|strict locator.
+-   `pathToFile` **[string][8]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### cancelPopup
@@ -408,9 +420,9 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element located by CSS | XPath | strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder[Additional options][8] for check available as 3rd argument.Examples:```js
+-   `field` **([string][8] | [object][5])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS | XPath | strict locator.
+    ⚠️ returns a _promise_ which is synchronized internally by recorder[Additional options][9] for check available as 3rd argument.Examples:```js
     // click on element at position
     I.checkOption('Agree', '.signup', { position: { x: 5, y: 5 } })
     ```> ⚠️ To avoid flakiness, option `force: true` is set by default 
@@ -428,7 +440,7 @@ I.clearCookie('test');
 
 #### Parameters
 
--   `cookie` **[string][7]?** (optional, `null` by default) cookie name
+-   `cookie` **[string][8]?** (optional, `null` by default) cookie name
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### clearField
@@ -444,7 +456,7 @@ I.clearField('#email');
 #### Parameters
 
 -   `field`  
--   `editable` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
+-   `editable` **([string][8] | [object][5])** field located by label|name|CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder.
 
 ### click
@@ -473,10 +485,10 @@ I.click({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][7]? | [object][5] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+-   `locator` **([string][8] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][8]? | [object][5] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
--   `opts` **any?** [Additional options][9] for click available as 3rd argument.Examples:```js
+-   `opts` **any?** [Additional options][10] for click available as 3rd argument.Examples:```js
     // click on element at position
     I.click('canvas', '.model', { position: { x: 20, y: 40 } })
 
@@ -521,8 +533,8 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 
 #### Parameters
 
--   `text` **[string][7]** which is not present.
--   `context` **([string][7] | [object][5])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+-   `text` **[string][8]** which is not present.
+-   `context` **([string][8] | [object][5])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### dontSeeCheckboxIsChecked
@@ -537,7 +549,7 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeCookie
@@ -550,7 +562,7 @@ I.dontSeeCookie('auth'); // no auth cookie
 
 #### Parameters
 
--   `name` **[string][7]** cookie name.
+-   `name` **[string][8]** cookie name.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeCurrentUrlEquals
@@ -565,7 +577,7 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
 
 #### Parameters
 
--   `url` **[string][7]** value to check.
+-   `url` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeElement
@@ -578,7 +590,7 @@ I.dontSeeElement('.modal'); // modal is not shown
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|Strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|Strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeElementInDOM
@@ -591,7 +603,7 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|Strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|Strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeInCurrentUrl
@@ -600,7 +612,7 @@ Checks that current url does not contain a provided fragment.
 
 #### Parameters
 
--   `url` **[string][7]** value to check.
+-   `url` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeInField
@@ -615,8 +627,8 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][7]** value to check.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeInSource
@@ -630,7 +642,7 @@ I.dontSeeInSource('<!--'); // no comments in source
 #### Parameters
 
 -   `text`  
--   `value` **[string][7]** to check.
+-   `value` **[string][8]** to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeInTitle
@@ -643,7 +655,7 @@ I.dontSeeInTitle('Error');
 
 #### Parameters
 
--   `text` **[string][7]** value to check.
+-   `text` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### doubleClick
@@ -660,8 +672,8 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+-   `locator` **([string][8] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### dragAndDrop
@@ -674,10 +686,10 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
--   `srcElement` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
--   `destElement` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `srcElement` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
+-   `destElement` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
--   `options` **any?** [Additional options][10] can be passed as 3rd argument.```js
+-   `options` **any?** [Additional options][11] can be passed as 3rd argument.```js
     // specify coordinates for source position
     I.dragAndDrop('img.src', 'img.dst', { sourcePosition: {x: 10, y: 10} })
     ```> By default option `force: true` is set 
@@ -694,8 +706,8 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `offsetX` **[number][11]** position to drag.
+-   `locator` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `offsetX` **[number][12]** position to drag.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### executeScript
@@ -723,9 +735,11 @@ If a function returns a Promise it will wait for its resolution.
 
 #### Parameters
 
--   `fn` **([string][7] | [function][12])** function to be executed in browser context.
+-   `fn` **([string][8] | [function][13])** function to be executed in browser context.
 -   `arg` **any?** optional argument to pass to the function
 
+Returns **[Promise][14]&lt;any>** 
+
 ### fillField
 
 Fills a text field or textarea, after clearing its value, with the given string.
@@ -744,8 +758,8 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `value` **([string][7] | [object][5])** text value to fill.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `value` **([string][8] | [object][5])** text value to fill.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### forceClick
@@ -777,8 +791,8 @@ I.forceClick({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+-   `locator` **([string][8] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### grabAttributeFrom
@@ -793,10 +807,10 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `attr` **[string][7]** attribute name.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][8]** attribute name.
 
-Returns **[Promise][13]&lt;[string][7]>** attribute value
+Returns **[Promise][14]&lt;[string][8]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -809,10 +823,10 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `attr` **[string][7]** attribute name.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][8]** attribute name.
 
-Returns **[Promise][13]&lt;[Array][14]&lt;[string][7]>>** attribute value
+Returns **[Promise][14]&lt;[Array][15]&lt;[string][8]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -824,9 +838,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][15]
+[Learn more about console messages][16]
 
-Returns **[Promise][13]&lt;[Array][14]&lt;any>>** 
+Returns **[Promise][14]&lt;[Array][15]&lt;any>>** 
 
 ### grabCookie
 
@@ -841,9 +855,9 @@ assert(cookie.value, '123456');
 
 #### Parameters
 
--   `name` **[string][7]?** cookie name. 
+-   `name` **[string][8]?** cookie name. 
 
-Returns **([Promise][13]&lt;[string][7]> | [Promise][13]&lt;[Array][14]&lt;[string][7]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
+Returns **([Promise][14]&lt;[string][8]> | [Promise][14]&lt;[Array][15]&lt;[string][8]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
 
 ### grabCssPropertyFrom
 
@@ -857,10 +871,10 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `cssProperty` **[string][7]** CSS property name.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `cssProperty` **[string][8]** CSS property name.
 
-Returns **[Promise][13]&lt;[string][7]>** CSS value
+Returns **[Promise][14]&lt;[string][8]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -873,10 +887,10 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `cssProperty` **[string][7]** CSS property name.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `cssProperty` **[string][8]** CSS property name.
 
-Returns **[Promise][13]&lt;[Array][14]&lt;[string][7]>>** CSS value
+Returns **[Promise][14]&lt;[Array][15]&lt;[string][8]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -888,7 +902,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][13]&lt;[string][7]>** current URL
+Returns **[Promise][14]&lt;[string][8]>** current URL
 
 ### grabDataFromPerformanceTiming
 
@@ -913,7 +927,7 @@ let data = await I.grabDataFromPerformanceTiming();
 }
 ```
 
-Returns **[Promise][13]&lt;any>** automatically synchronized promise through #recorder
+Returns **[Promise][14]&lt;any>** automatically synchronized promise through #recorder
 
 ### grabElementBoundingRect
 
@@ -937,11 +951,11 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
 -   `prop`  
--   `elementSize` **[string][7]?** x, y, width or height of the given element.
+-   `elementSize` **[string][8]?** x, y, width or height of the given element.
 
-Returns **([Promise][13]&lt;DOMRect> | [Promise][13]&lt;[number][11]>)** Element bounding rectangle
+Returns **([Promise][14]&lt;DOMRect> | [Promise][14]&lt;[number][12]>)** Element bounding rectangle
 
 ### grabHTMLFrom
 
@@ -956,9 +970,9 @@ let postHTML = await I.grabHTMLFrom('#post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `element` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[string][7]>** HTML code for an element
+Returns **[Promise][14]&lt;[string][8]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -972,9 +986,9 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `element` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[Array][14]&lt;[string][7]>>** HTML code for an element
+Returns **[Promise][14]&lt;[Array][15]&lt;[string][8]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -985,7 +999,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][13]&lt;[number][11]>** number of open tabs
+Returns **[Promise][14]&lt;[number][12]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -998,9 +1012,9 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[number][11]>** number of visible elements
+Returns **[Promise][14]&lt;[number][12]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -1011,7 +1025,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][13]&lt;PageScrollPosition>** scroll position
+Returns **[Promise][14]&lt;PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -1021,7 +1035,7 @@ Grab the text within the popup. If no popup is visible then it will return null
 await I.grabPopupText();
 ```
 
-Returns **[Promise][13]&lt;([string][7] | null)>** 
+Returns **[Promise][14]&lt;([string][8] | null)>** 
 
 ### grabSource
 
@@ -1032,7 +1046,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][13]&lt;[string][7]>** source code
+Returns **[Promise][14]&lt;[string][8]>** source code
 
 ### grabTextFrom
 
@@ -1047,9 +1061,9 @@ If multiple elements found returns first element.
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[string][7]>** attribute value
+Returns **[Promise][14]&lt;[string][8]>** attribute value
 
 ### grabTextFromAll
 
@@ -1062,9 +1076,9 @@ let pins = await I.grabTextFromAll('#pin li');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[Array][14]&lt;[string][7]>>** attribute value
+Returns **[Promise][14]&lt;[Array][15]&lt;[string][8]>>** attribute value
 
 ### grabTitle
 
@@ -1075,7 +1089,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][13]&lt;[string][7]>** title
+Returns **[Promise][14]&lt;[string][8]>** title
 
 ### grabValueFrom
 
@@ -1089,9 +1103,9 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[string][7]>** attribute value
+Returns **[Promise][14]&lt;[string][8]>** attribute value
 
 ### grabValueFromAll
 
@@ -1104,29 +1118,29 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][13]&lt;[Array][14]&lt;[string][7]>>** attribute value
+Returns **[Promise][14]&lt;[Array][15]&lt;[string][8]>>** attribute value
 
 ### handleDownloads
 
-Handles a file download.Aa file name is required to save the file on disk.
+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][16] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][17] to check that file were downloaded correctly.
 
 ```js
 I.handleDownloads('downloads/avatar.jpg');
 I.click('Download Avatar');
 I.amInPath('output/downloads');
-I.waitForFile('downloads/avatar.jpg', 5);
+I.waitForFile('avatar.jpg', 5);
 ```
 
 #### Parameters
 
--   `fileName` **[string][7]?** set filename for downloaded file 
+-   `fileName` **[string][8]?** set filename for downloaded file
 
-Returns **[Promise][13]&lt;void>** 
+Returns **[Promise][14]&lt;void>** 
 
 ### haveRequestHeaders
 
@@ -1144,7 +1158,7 @@ I.haveRequestHeaders({
 
 ### makeApiRequest
 
-Performs [api request][17] using
+Performs [api request][18] using
 the cookies from the current browser session.
 
 ```js
@@ -1157,26 +1171,26 @@ I.makeApiRequest('PATCH', )
 
 #### Parameters
 
--   `method` **[string][7]** HTTP method
--   `url` **[string][7]** endpoint
+-   `method` **[string][8]** HTTP method
+-   `url` **[string][8]** endpoint
 -   `options` **[object][5]** request options depending on method used
 
-Returns **[Promise][13]&lt;[object][5]>** response
+Returns **[Promise][14]&lt;[object][5]>** response
 
 ### mockRoute
 
-Mocks network request using [`browserContext.route`][18] of Playwright
+Mocks network request using [`browserContext.route`][19] of Playwright
 
 ```js
 I.mockRoute(/(.png$)|(.jpg$)/, route => route.abort());
 ```
 
-This method allows intercepting and mocking requests & responses. [Learn more about it][19]
+This method allows intercepting and mocking requests & responses. [Learn more about it][20]
 
 #### Parameters
 
--   `url` **([string][7] | [RegExp][20])?** URL, regex or pattern for to match URL
--   `handler` **[function][12]?** a function to process reques
+-   `url` **([string][8] | [RegExp][21])?** URL, regex or pattern for to match URL
+-   `handler` **[function][13]?** a function to process reques
 
 ### moveCursorTo
 
@@ -1190,9 +1204,9 @@ I.moveCursorTo('#submit', 5,5);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** 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.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
+-   `offsetX` **[number][12]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][12]** (optional, `0` by default) Y-axis offset.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### openNewTab
@@ -1203,7 +1217,7 @@ Open new tab and automatically switched to new tab
 I.openNewTab();
 ```
 
-You can pass in [page options][21] to emulate device on this page
+You can pass in [page options][22] to emulate device on this page
 
 ```js
 // enable mobile
@@ -1218,7 +1232,7 @@ I.openNewTab({ isMobile: true });
 
 Presses a key in the browser (on a focused element).
 
-_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][22].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][23].
 
 ```js
 I.pressKey('Backspace');
@@ -1277,14 +1291,14 @@ Some of the supported key names are:
 
 #### Parameters
 
--   `key` **([string][7] | [Array][14]&lt;[string][7]>)** 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][23]).
+-   `key` **([string][8] | [Array][15]&lt;[string][8]>)** 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][24]).
 
 ### 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`][24]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][25]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1294,14 +1308,14 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
--   `key` **[string][7]** name of key to press down.
+-   `key` **[string][8]** name of key to press down.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### pressKeyUp
 
 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`][24]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][25]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1311,7 +1325,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
--   `key` **[string][7]** name of key to release.
+-   `key` **[string][8]** name of key to release.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### refreshPage
@@ -1331,8 +1345,8 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
--   `width` **[number][11]** width in pixels or `maximize`.
--   `height` **[number][11]** height in pixels.
+-   `width` **[number][12]** width in pixels or `maximize`.
+-   `height` **[number][12]** height in pixels.
     ⚠️ returns a _promise_ which is synchronized internally by recorderUnlike other drivers Playwright changes the size of a viewport, not the window!
     Playwright does not control the window of a browser so it can't adjust its real size.
     It also can't maximize a window.Update configuration to change real window size on start:```js
@@ -1341,6 +1355,23 @@ First parameter can be set to `maximize`.
     { setWindowSize } = require('@codeceptjs/configure');
     ```
 
+### restartBrowser
+
+Restart browser with a new context and a new page
+
+```js
+// Restart browser and use a new timezone
+I.restartBrowser({ timezoneId: 'America/Phoenix' });
+// Open URL in a new page in changed timezone
+I.amOnPage('/');
+// Restart browser, allow reading/copying of text from/into clipboard in Chrome
+I.restartBrowser({ permissions: ['clipboard-read', 'clipboard-write'] });
+```
+
+#### Parameters
+
+-   `contextOptions` **[object][5]?** [Options for browser context][6] when starting new browser
+
 ### rightClick
 
 Performs right click on a clickable element matched by semantic locator, CSS or XPath.
@@ -1356,8 +1387,8 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** clickable element located by CSS|XPath|strict locator.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** clickable element located by CSS|XPath|strict locator.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### saveElementScreenshot
@@ -1371,8 +1402,8 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `fileName` **[string][7]** file name to save.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `fileName` **[string][8]** file name to save.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### saveScreenshot
@@ -1388,8 +1419,8 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 
 #### Parameters
 
--   `fileName` **[string][7]** file name to save.
--   `fullPage` **[boolean][25]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
+-   `fileName` **[string][8]** file name to save.
+-   `fullPage` **[boolean][26]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### scrollPageToBottom
@@ -1424,9 +1455,9 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** 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.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
+-   `offsetX` **[number][12]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][12]** (optional, `0` by default) Y-axis offset.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### see
@@ -1442,8 +1473,8 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
--   `text` **[string][7]** expected on page.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+-   `text` **[string][8]** expected on page.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### seeAttributesOnElements
@@ -1456,7 +1487,7 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
 -   `attributes` **[object][5]** attributes and their values to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
@@ -1472,7 +1503,7 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeCookie
@@ -1485,7 +1516,7 @@ I.seeCookie('Auth');
 
 #### Parameters
 
--   `name` **[string][7]** cookie name.
+-   `name` **[string][8]** cookie name.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeCssPropertiesOnElements
@@ -1498,7 +1529,7 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
 -   `cssProperties` **[object][5]** object with CSS properties and their values to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
@@ -1515,7 +1546,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 #### Parameters
 
--   `url` **[string][7]** value to check.
+-   `url` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeElement
@@ -1529,7 +1560,7 @@ I.seeElement('#modal');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeElementInDOM
@@ -1543,7 +1574,7 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeInCurrentUrl
@@ -1556,7 +1587,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 #### Parameters
 
--   `url` **[string][7]** a fragment to check
+-   `url` **[string][8]** a fragment to check
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeInField
@@ -1573,8 +1604,8 @@ I.seeInField('#searchform input','Search');
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][7]** value to check.
+-   `field` **([string][8] | [object][5])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeInPopup
@@ -1588,7 +1619,7 @@ I.seeInPopup('Popup text');
 
 #### Parameters
 
--   `text` **[string][7]** value to check.
+-   `text` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeInSource
@@ -1601,7 +1632,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
--   `text` **[string][7]** value to check.
+-   `text` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeInTitle
@@ -1614,7 +1645,7 @@ I.seeInTitle('Home Page');
 
 #### Parameters
 
--   `text` **[string][7]** text value to check.
+-   `text` **[string][8]** text value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeNumberOfElements
@@ -1628,8 +1659,8 @@ I.seeNumberOfElements('#submitBtn', 1);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `num` **[number][11]** number of elements.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `num` **[number][12]** number of elements.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeNumberOfVisibleElements
@@ -1643,8 +1674,8 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `num` **[number][11]** number of elements.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `num` **[number][12]** number of elements.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### seeTextEquals
@@ -1657,8 +1688,8 @@ I.seeTextEquals('text', 'h1');
 
 #### Parameters
 
--   `text` **[string][7]** element value to check.
--   `context` **([string][7] | [object][5])?** element located by CSS|XPath|strict locator.
+-   `text` **[string][8]** element value to check.
+-   `context` **([string][8] | [object][5])?** element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### seeTitleEquals
@@ -1671,7 +1702,7 @@ I.seeTitleEquals('Test title.');
 
 #### Parameters
 
--   `text` **[string][7]** value to check.
+-   `text` **[string][8]** value to check.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### selectOption
@@ -1697,8 +1728,8 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
--   `select` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
--   `option` **([string][7] | [Array][14]&lt;any>)** visible text or value of option.
+-   `select` **([string][8] | [object][5])** field located by label|name|CSS|XPath|strict locator.
+-   `option` **([string][8] | [Array][15]&lt;any>)** visible text or value of option.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### setCookie
@@ -1719,7 +1750,7 @@ I.setCookie([
 
 #### Parameters
 
--   `cookie` **(Cookie | [Array][14]&lt;Cookie>)** a cookie object or array of cookie objects.
+-   `cookie` **(Cookie | [Array][15]&lt;Cookie>)** a cookie object or array of cookie objects.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### stopMockingRoute
@@ -1735,8 +1766,8 @@ If no handler is passed, all mock requests for the rote are disabled.
 
 #### Parameters
 
--   `url` **([string][7] | [RegExp][20])?** URL, regex or pattern for to match URL
--   `handler` **[function][12]?** a function to process reques
+-   `url` **([string][8] | [RegExp][21])?** URL, regex or pattern for to match URL
+-   `handler` **[function][13]?** a function to process reques
 
 ### switchTo
 
@@ -1749,7 +1780,7 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
--   `locator` **([string][7]? | [object][5])** (optional, `null` by default) element located by CSS|XPath|strict locator.
+-   `locator` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### switchToNextTab
@@ -1763,7 +1794,7 @@ I.switchToNextTab(2);
 
 #### Parameters
 
--   `num` **[number][11]**  
+-   `num` **[number][12]**  
 
 ### switchToPreviousTab
 
@@ -1776,13 +1807,13 @@ I.switchToPreviousTab(2);
 
 #### Parameters
 
--   `num` **[number][11]**  
+-   `num` **[number][12]**  
 
 ### 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`][22] is not an option.
+_Note:_ Should be used when [`fillField`][23] is not an option.
 
 ```js
 // passing in a string
@@ -1798,9 +1829,9 @@ I.type(['T', 'E', 'X', 'T']);
 #### Parameters
 
 -   `keys`  
--   `delay` **[number][11]?** (optional) delay in ms between key presses
+-   `delay` **[number][12]?** (optional) delay in ms between key presses
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
--   `key` **([string][7] | [Array][14]&lt;[string][7]>)** or array of keys to type.
+-   `key` **([string][8] | [Array][15]&lt;[string][8]>)** or array of keys to type.
 
 ### uncheckOption
 
@@ -1817,9 +1848,9 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][7]? | [object][5])** (optional, `null` by default) element located by CSS | XPath | strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder[Additional options][26] for uncheck available as 3rd argument.Examples:```js
+-   `field` **([string][8] | [object][5])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS | XPath | strict locator.
+    ⚠️ returns a _promise_ which is synchronized internally by recorder[Additional options][27] for uncheck available as 3rd argument.Examples:```js
     // click on element at position
     I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
     ```> ⚠️ To avoid flakiness, option `force: true` is set by default 
@@ -1832,7 +1863,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`][27], [`browserContext`][28] [`browser`][29] } objects from Playwright API are available.
+{ [`page`][28], [`browserContext`][29] [`browser`][30] } objects from Playwright API are available.
 
 ```js
 I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
@@ -1842,8 +1873,8 @@ I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
 
 #### Parameters
 
--   `description` **[string][7]** used to show in logs.
--   `fn` **[function][12]** async function that executed with Playwright helper as argumen
+-   `description` **[string][8]** used to show in logs.
+-   `fn` **[function][13]** async function that executed with Playwright helper as argumen
 
 ### wait
 
@@ -1855,7 +1886,7 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
--   `sec` **[number][11]** number of second to wait.
+-   `sec` **[number][12]** number of second to wait.
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### waitForClickable
@@ -1870,9 +1901,9 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
 -   `waitTimeout`  
--   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][12]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### waitForDetached
@@ -1886,8 +1917,8 @@ I.waitForDetached('#popup');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForElement
@@ -1902,8 +1933,8 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### waitForEnabled
@@ -1913,8 +1944,8 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]** (optional) time in seconds to wait, 1 by default.
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]** (optional) time in seconds to wait, 1 by default.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForFunction
@@ -1934,9 +1965,9 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][7] | [function][12])** to be executed in browser context.
--   `argsOrSec` **([Array][14]&lt;any> | [number][11])?** (optional, `1` by default) arguments for function or seconds. 
--   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
+-   `fn` **([string][8] | [function][13])** to be executed in browser context.
+-   `argsOrSec` **([Array][15]&lt;any> | [number][12])?** (optional, `1` by default) arguments for function or seconds. 
+-   `sec` **[number][12]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForInvisible
@@ -1950,15 +1981,15 @@ I.waitForInvisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]** (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 [Playwright's reference][30]
+See [Playwright's reference][31]
 
 #### Parameters
 
@@ -1975,8 +2006,8 @@ I.waitForRequest(request => request.url() === 'http://example.com' && request.me
 
 #### Parameters
 
--   `urlOrPredicate` **([string][7] | [function][12])** 
--   `sec` **[number][11]?** seconds to wait 
+-   `urlOrPredicate` **([string][8] | [function][13])** 
+-   `sec` **[number][12]?** seconds to wait 
 
 ### waitForResponse
 
@@ -1989,8 +2020,8 @@ I.waitForResponse(response => response.url() === 'https://example.com' && respon
 
 #### Parameters
 
--   `urlOrPredicate` **([string][7] | [function][12])** 
--   `sec` **[number][11]?** number of seconds to wait 
+-   `urlOrPredicate` **([string][8] | [function][13])** 
+-   `sec` **[number][12]?** number of seconds to wait 
 
 ### waitForText
 
@@ -2005,9 +2036,9 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
--   `text` **[string][7]** to wait for.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait 
--   `context` **([string][7] | [object][5])?** (optional) element located by CSS|XPath|strict locator.
+-   `text` **[string][8]** to wait for.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait 
+-   `context` **([string][8] | [object][5])?** (optional) element located by CSS|XPath|strict locator.
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForValue
@@ -2020,9 +2051,9 @@ I.waitForValue('//input', "GoodValue");
 
 #### Parameters
 
--   `field` **([string][7] | [object][5])** input field.
--   `value` **[string][7]** expected value.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `field` **([string][8] | [object][5])** input field.
+-   `value` **[string][8]** expected value.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitForVisible
@@ -2036,9 +2067,9 @@ I.waitForVisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][31]. 
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
+    ⚠️ returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][32]. 
 
 ### waitInUrl
 
@@ -2050,8 +2081,8 @@ I.waitInUrl('/info', 2);
 
 #### Parameters
 
--   `urlPart` **[string][7]** value to check.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `urlPart` **[string][8]** value to check.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitNumberOfVisibleElements
@@ -2064,9 +2095,9 @@ I.waitNumberOfVisibleElements('a', 3);
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** 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
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `num` **[number][12]** number of elements.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitToHide
@@ -2080,8 +2111,8 @@ I.waitToHide('#popup');
 
 #### Parameters
 
--   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
 ### waitUrlEquals
@@ -2095,11 +2126,11 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 #### Parameters
 
--   `urlPart` **[string][7]** value to check.
--   `sec` **[number][11]** (optional, `1` by default) time in seconds to wait
+-   `urlPart` **[string][8]** value to check.
+-   `sec` **[number][12]** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
 
-: https://github.com/microsoft/playwright
+[1]: https://github.com/microsoft/playwright
 
 [2]: https://playwright.dev/docs/next/api/class-browser#browser-new-context
 
@@ -2109,64 +2140,68 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
 
-[6]: http://jster.net/category/windows-modals-popups
+[6]: https://playwright.dev/docs/api/class-browser#browser-new-context
+
+[7]: http://jster.net/category/windows-modals-popups
+
+[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[9]: https://playwright.dev/docs/api/class-elementhandle#element-handle-check
 
-[8]: https://playwright.dev/docs/api/class-elementhandle#element-handle-check
+[10]: https://playwright.dev/docs/api/class-page#page-click
 
-[9]: https://playwright.dev/docs/api/class-page#page-click
+[11]: https://playwright.dev/docs/api/class-page#page-drag-and-drop
 
-[10]: https://playwright.dev/docs/api/class-page#page-drag-and-drop
+[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[13]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[13]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[16]: https://playwright.dev/docs/api/class-consolemessage
 
-[15]: https://playwright.dev/docs/api/class-consolemessage
+[17]: https://codecept.io/helpers/FileSystem
 
-[16]: https://codecept.io/helpers/FileSystem
+[18]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
 
-[17]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
+[19]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
 
-[18]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
+[20]: https://playwright.dev/docs/network#handle-requests
 
-[19]: https://playwright.dev/docs/network#handle-requests
+[21]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
 
-[20]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+[22]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
 
-[21]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
+[23]: #fillfield
 
-[22]: #fillfield
+[24]: https://github.com/GoogleChrome/puppeteer/issues/1313
 
-[23]: https://github.com/GoogleChrome/puppeteer/issues/1313
+[25]: #click
 
-[24]: #click
+[26]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[27]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
 
-[26]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
+[28]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
 
-[27]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
+[29]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
 
-[28]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
+[30]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
 
-[29]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
+[31]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
 
-[30]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
+[32]: https://codecept.io/react
 
-[31]: https://codecept.io/react
+[33]: https://playwright.dev/docs/api/class-browsercontext
 
-[32]: https://playwright.dev/docs/api/class-browsercontext
+[34]: https://playwright.dev/docs/api/class-page#page-set-default-timeout
 
-[33]: https://playwright.dev/docs/api/class-page#page-set-default-timeout
+[35]: https://playwright.dev/docs/trace-viewer
 
-[34]: https://playwright.dev/docs/trace-viewer
+[36]: https://playwright.dev/docs/api/class-page#page-wait-for-navigation
 
-[35]: https://playwright.dev/docs/api/class-page#page-wait-for-navigation
+[37]: https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge
 
-[36]: https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge
+[38]: https://playwright.dev/docs/api/class-consolemessage#console-message-type