codeceptjs 3.5.11 → 3.5.12-beta.2

package/docs/helpers/WebDriver.md

@@ -16,36 +16,45 @@ manipulate browser using Selenium WebDriver or PhantomJS.
 
 WebDriver requires Selenium Server and ChromeDriver/GeckoDriver to be installed. Those tools can be easily installed via NPM. Please check [Testing with WebDriver][2] for more details.
 
+With the release of WebdriverIO version v8.14.0, and onwards, all driver management hassles are now a thing of the past 🙌. Read more [here][3].
+One of the significant advantages of this update is that you can now get rid of any driver services you previously had to manage, such as
+`wdio-chromedriver-service`, `wdio-geckodriver-service`, `wdio-edgedriver-service`, `wdio-safaridriver-service`, and even `@wdio/selenium-standalone-service`.
+
+For those who require custom driver options, fear not; WebDriver Helper allows you to pass in driver options through custom WebDriver configuration.
+If you have a custom grid, use a cloud service, or prefer to run your own driver, there's no need to worry since WebDriver Helper will only start a driver when there are no other connection information settings like hostname or port specified.
+
 
 
 ## Configuration
 
 This helper should be configured in codecept.conf.js
 
-Type: [object][16]
+Type: [object][17]
 
 ### Properties
 
--   `url` **[string][17]** base url of website to be tested.
--   `browser` **[string][17]** Browser in which to perform testing.
--   `basicAuth` **[string][17]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
--   `host` **[string][17]?** WebDriver host to connect.
--   `port` **[number][22]?** WebDriver port to connect.
--   `protocol` **[string][17]?** protocol for WebDriver server.
--   `path` **[string][17]?** path to WebDriver server.
--   `restart` **[boolean][32]?** restart browser between tests.
--   `smartWait` **([boolean][32] | [number][22])?** **enables [SmartWait][36]**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
--   `disableScreenshots` **[boolean][32]?** don't save screenshots on failure.
--   `fullPageScreenshots` **[boolean][32]?** (optional - make full page screenshots on failure.
--   `uniqueScreenshotNames` **[boolean][32]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
--   `keepBrowserState` **[boolean][32]?** keep browser state between tests when `restart` is set to false.
--   `keepCookies` **[boolean][32]?** keep cookies between tests when `restart` set to false.
--   `windowSize` **[string][17]?** default window size. Set to `maximize` or a dimension in the format `640x480`.
--   `waitForTimeout` **[number][22]?** sets default wait time in _ms_ for all `wait*` functions.
--   `desiredCapabilities` **[object][16]?** Selenium's [desired capabilities][6].
--   `manualStart` **[boolean][32]?** do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriver"]._startBrowser()`.
--   `timeouts` **[object][16]?** [WebDriver timeouts][37] defined as hash.
--   `highlightElement` **[boolean][32]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+-   `url` **[string][18]** base url of website to be tested.
+-   `browser` **[string][18]** Browser in which to perform testing.
+-   `basicAuth` **[string][18]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
+-   `host` **[string][18]?** WebDriver host to connect.
+-   `port` **[number][23]?** WebDriver port to connect.
+-   `protocol` **[string][18]?** protocol for WebDriver server.
+-   `path` **[string][18]?** path to WebDriver server.
+-   `restart` **[boolean][33]?** restart browser between tests.
+-   `smartWait` **([boolean][33] | [number][23])?** **enables [SmartWait][37]**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
+-   `disableScreenshots` **[boolean][33]?** don't save screenshots on failure.
+-   `fullPageScreenshots` **[boolean][33]?** (optional - make full page screenshots on failure.
+-   `uniqueScreenshotNames` **[boolean][33]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+-   `keepBrowserState` **[boolean][33]?** keep browser state between tests when `restart` is set to false.
+-   `keepCookies` **[boolean][33]?** keep cookies between tests when `restart` set to false.
+-   `windowSize` **[string][18]?** default window size. Set to `maximize` or a dimension in the format `640x480`.
+-   `waitForTimeout` **[number][23]?** sets default wait time in _ms_ for all `wait*` functions.
+-   `desiredCapabilities` **[object][17]?** Selenium's [desired capabilities][7].
+-   `manualStart` **[boolean][33]?** do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriver"]._startBrowser()`.
+-   `timeouts` **[object][17]?** [WebDriver timeouts][38] defined as hash.
+-   `highlightElement` **[boolean][33]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+-   `logLevel` **[string][18]?** level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: [https://webdriver.io/docs/configuration/#loglevel][39]
+-   `devtoolsProtocol` **[boolean][33]?** enable devtools protocol. Default: false. More info: [https://webdriver.io/docs/automationProtocols/#devtools-protocol][40].
 
 
 
@@ -68,6 +77,27 @@ Example:
 }
 ```
 
+Testing Chrome locally is now more convenient than ever. You can define a browser channel, and WebDriver Helper will take care of downloading the specified browser version for you.
+For example:
+
+```js
+{
+   helpers: {
+     WebDriver : {
+       smartWait: 5000,
+       browser: "chrome",
+       browserVersion: '116.0.5793.0', // or 'stable', 'beta', 'dev' or 'canary'
+       restart: false,
+       windowSize: "maximize",
+       timeouts: {
+         "script": 60000,
+         "page load": 10000
+       }
+     }
+   }
+}
+```
+
 Example with basic authentication
 
 ```js
@@ -89,7 +119,7 @@ Example with basic authentication
 ```
 
 Additional configuration params can be used from [webdriverio
-website][3].
+website][4].
 
 ### Headless Chrome
 
@@ -109,9 +139,28 @@ website][3].
 }
 ```
 
+### Running with devtools protocol
+
+```js
+{
+   helpers: {
+     WebDriver : {
+       url: "http://localhost",
+       browser: "chrome",
+       devtoolsProtocol: true,
+       desiredCapabilities: {
+         chromeOptions: {
+           args: [ "--headless", "--disable-gpu", "--no-sandbox" ]
+         }
+       }
+     }
+   }
+}
+```
+
 ### Internet Explorer
 
-Additional configuration params can be used from [IE options][4]
+Additional configuration params can be used from [IE options][5]
 
 ```js
 {
@@ -133,7 +182,7 @@ Additional configuration params can be used from [IE options][4]
 
 ### Selenoid Options
 
-[Selenoid][5] is a modern way to run Selenium inside Docker containers.
+[Selenoid][6] is a modern way to run Selenium inside Docker containers.
 Selenoid is easy to set up and provides more features than original Selenium Server. Use `selenoidOptions` to set Selenoid capabilities
 
 ```js
@@ -199,13 +248,13 @@ For example,
 }
 ```
 
-Please refer to [Selenium - Proxy Object][6] for more
+Please refer to [Selenium - Proxy Object][7] for more
 information.
 
 ### Cloud Providers
 
 WebDriver makes it possible to execute tests against services like `Sauce Labs` `BrowserStack` `TestingBot`
-Check out their documentation on [available parameters][7]
+Check out their documentation on [available parameters][8]
 
 Connecting to `BrowserStack` and `Sauce Labs` is simple. All you need to do
 is set the `user` and `key` parameters. WebDriver automatically know which
@@ -254,9 +303,9 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][8].
+See [complete reference on webdriver.io][9].
 
-> Alternatively, use [codeceptjs-saucehelper][9] for better reporting.
+> Alternatively, use [codeceptjs-saucehelper][10] for better reporting.
 
 #### BrowserStack
 
@@ -280,13 +329,13 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][10].
+See [complete reference on webdriver.io][11].
 
-> Alternatively, use [codeceptjs-bshelper][11] for better reporting.
+> Alternatively, use [codeceptjs-bshelper][12] for better reporting.
 
 #### TestingBot
 
-> **Recommended**: use official [TestingBot Helper][12].
+> **Recommended**: use official [TestingBot Helper][13].
 
 Alternatively, TestingBot can be configured via wdio service, which should be installed additionally:
 
@@ -308,20 +357,20 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][13].
+See [complete reference on webdriver.io][14].
 
 #### Applitools
 
 Visual testing via Applitools service
 
-> Use [CodeceptJS Applitools Helper][14] with Applitools wdio service.
+> Use [CodeceptJS Applitools Helper][15] with Applitools wdio service.
 
 ### Multiremote Capabilities
 
 This is a work in progress but you can control two browsers at a time right out of the box.
 Individual control is something that is planned for a later version.
 
-Here is the [webdriverio docs][15] on the subject
+Here is the [webdriverio docs][16] on the subject
 
 ```js
 {
@@ -365,7 +414,7 @@ Check if locator is type of "Shadow"
 
 #### Parameters
 
--   `locator` **[object][16]** 
+-   `locator` **[object][17]** 
 
 ### _locate
 
@@ -378,7 +427,7 @@ this.helpers['WebDriver']._locate({name: 'password'}).then //...
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 -   `smartWait`   
 
 ### _locateCheckable
@@ -391,7 +440,7 @@ this.helpers['WebDriver']._locateCheckable('I agree with terms and conditions').
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
 ### _locateClickable
 
@@ -404,7 +453,7 @@ const els = await this.helpers.WebDriver._locateClickable('Next page', '.pages')
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 -   `context`  
 
 ### _locateFields
@@ -417,7 +466,7 @@ this.helpers['WebDriver']._locateFields('Your email').then // ...
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
 ### _locateShadow
 
@@ -425,7 +474,7 @@ Locate Element within the Shadow Dom
 
 #### Parameters
 
--   `locator` **[object][16]** 
+-   `locator` **[object][17]** 
 
 ### _smartWait
 
@@ -433,13 +482,13 @@ Smart Wait to locate an element
 
 #### Parameters
 
--   `locator` **[object][16]** 
+-   `locator` **[object][17]** 
 
 ### acceptPopup
 
 Accepts the active JavaScript native popup window, as created by window.alert|window.confirm|window.prompt.
 Don't confuse popups with modal windows, as created by [various
-libraries][18].
+libraries][19].
 
 ### amOnPage
 
@@ -454,7 +503,7 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
--   `url` **[string][17]** url path or global url.
+-   `url` **[string][18]** url path or global url.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -471,8 +520,8 @@ I.appendField('password', secret('123456'));
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator
--   `value` **[string][17]** text value to append.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator
+-   `value` **[string][18]** text value to append.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -495,15 +544,15 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
--   `pathToFile` **[string][17]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
+-   `locator` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
+-   `pathToFile` **[string][18]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### blur
 
 Remove focus from a text input, button, etc.
-Calls [blur][19] on the element.
+Calls [blur][20] on the element.
 
 Examples:
 
@@ -520,8 +569,8 @@ I.dontSee('#add-to-cart-btn');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
--   `options` **any?** Playwright only: [Additional options][20] for available options object as 2nd argument.
+-   `locator` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
+-   `options` **any?** Playwright only: [Additional options][21] for available options object as 2nd argument.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -545,8 +594,8 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+-   `field` **([string][18] | [object][17])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -562,7 +611,7 @@ I.clearCookie('test'); // Playwright currently doesn't support clear a particula
 
 #### Parameters
 
--   `cookie` **[string][17]?** (optional, `null` by default) cookie name 
+-   `cookie` **[string][18]?** (optional, `null` by default) cookie name 
 
 ### clearField
 
@@ -577,7 +626,7 @@ I.clearField('#email');
 #### Parameters
 
 -   `field`  
--   `editable` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
+-   `editable` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder.
 
@@ -607,8 +656,8 @@ I.click({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+-   `locator` **([string][18] | [object][17])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][18]? | [object][17] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -638,7 +687,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 ### defineTimeout
 
-Set [WebDriver timeouts][21] in realtime.
+Set [WebDriver timeouts][22] in realtime.
 
 Timeouts are expected to be passed as object:
 
@@ -663,8 +712,8 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 
 #### Parameters
 
--   `text` **[string][17]** which is not present.
--   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
+-   `text` **[string][18]** which is not present.
+-   `context` **([string][18] | [object][17])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -685,7 +734,7 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -699,7 +748,7 @@ I.dontSeeCookie('auth'); // no auth cookie
 
 #### Parameters
 
--   `name` **[string][17]** cookie name.
+-   `name` **[string][18]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -715,7 +764,7 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
 
 #### Parameters
 
--   `url` **[string][17]** value to check.
+-   `url` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -729,7 +778,7 @@ I.dontSeeElement('.modal'); // modal is not shown
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|Strict locator.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|Strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -747,7 +796,7 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|Strict locator.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|Strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -757,7 +806,7 @@ Checks that current url does not contain a provided fragment.
 
 #### Parameters
 
--   `url` **[string][17]** value to check.
+-   `url` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -773,8 +822,8 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
--   `value` **([string][17] | [object][16])** value to check.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
+-   `value` **([string][18] | [object][17])** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -789,7 +838,7 @@ I.dontSeeInSource('<!--'); // no comments in source
 #### Parameters
 
 -   `text`  
--   `value` **[string][17]** to check.
+-   `value` **[string][18]** to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -803,7 +852,7 @@ I.dontSeeInTitle('Error');
 
 #### Parameters
 
--   `text` **[string][17]** value to check.
+-   `text` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -821,8 +870,8 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+-   `locator` **([string][18] | [object][17])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -841,8 +890,8 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
--   `srcElement` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `destElement` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `srcElement` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
+-   `destElement` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -858,8 +907,8 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
--   `offsetX` **[number][22]** position to drag. 
+-   `locator` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
+-   `offsetX` **[number][23]** position to drag. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -868,7 +917,7 @@ Returns **void** automatically synchronized promise through #recorder
 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][23].
+Example: In Vue.js to make components completely rendered we are waiting for [nextTick][24].
 
 ```js
 I.executeAsyncScript(function(done) {
@@ -889,13 +938,13 @@ let val = await I.executeAsyncScript(function(url, done) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
--   `fn` **([string][17] | [function][24])** function to be executed in browser context.
+-   `fn` **([string][18] | [function][25])** function to be executed in browser context.
 
-Returns **[Promise][25]&lt;any>** script return value
+Returns **[Promise][26]&lt;any>** script return value
 
 ### executeScript
 
-Wraps [execute][26] command.
+Wraps [execute][27] command.
 
 Executes sync script on a page.
 Pass arguments to function as additional parameters.
@@ -924,9 +973,9 @@ let date = await I.executeScript(function(el) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
--   `fn` **([string][17] | [function][24])** function to be executed in browser context.
+-   `fn` **([string][18] | [function][25])** function to be executed in browser context.
 
-Returns **[Promise][25]&lt;any>** script return value
+Returns **[Promise][26]&lt;any>** script return value
 
 ### fillField
 
@@ -946,8 +995,8 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
--   `value` **([string][17] | [object][16])** text value to fill.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
+-   `value` **([string][18] | [object][17])** text value to fill.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -958,7 +1007,7 @@ This action supports [React locators](https://codecept.io/react#locators)
 
 ### focus
 
-Calls [focus][19] on the matching element.
+Calls [focus][20] on the matching element.
 
 Examples:
 
@@ -970,8 +1019,8 @@ I.see('#add-to-cart-bnt');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
--   `options` **any?** Playwright only: [Additional options][27] for available options object as 2nd argument.
+-   `locator` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
+-   `options` **any?** Playwright only: [Additional options][28] for available options object as 2nd argument.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1004,8 +1053,8 @@ I.forceClick({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+-   `locator` **([string][18] | [object][17])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1032,8 +1081,8 @@ I.forceRightClick('Menu');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+-   `locator` **([string][18] | [object][17])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1050,7 +1099,7 @@ Useful for referencing a specific handle when calling `I.switchToWindow(handle)`
 const windows = await I.grabAllWindowHandles();
 ```
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** 
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** 
 
 ### grabAttributeFrom
 
@@ -1064,10 +1113,10 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `attr` **[string][17]** attribute name.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][18]** attribute name.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][26]&lt;[string][18]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -1080,10 +1129,10 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `attr` **[string][17]** attribute name.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][18]** attribute name.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -1095,7 +1144,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **([Promise][25]&lt;[Array][28]&lt;[object][16]>> | [undefined][29])** all browser logs
+Returns **([Promise][26]&lt;[Array][29]&lt;[object][17]>> | [undefined][30])** all browser logs
 
 ### grabCookie
 
@@ -1110,7 +1159,7 @@ assert(cookie.value, '123456');
 
 #### Parameters
 
--   `name` **[string][17]?** cookie name. 
+-   `name` **[string][18]?** cookie name. 
 
 Returns **any** attribute value
 
@@ -1126,10 +1175,10 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `cssProperty` **[string][17]** CSS property name.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `cssProperty` **[string][18]** CSS property name.
 
-Returns **[Promise][25]&lt;[string][17]>** CSS value
+Returns **[Promise][26]&lt;[string][18]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -1142,10 +1191,10 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `cssProperty` **[string][17]** CSS property name.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `cssProperty` **[string][18]** CSS property name.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** CSS value
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -1157,7 +1206,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** current URL
+Returns **[Promise][26]&lt;[string][18]>** current URL
 
 ### grabCurrentWindowHandle
 
@@ -1168,7 +1217,7 @@ Useful for referencing it when calling `I.switchToWindow(handle)`
 const window = await I.grabCurrentWindowHandle();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** 
+Returns **[Promise][26]&lt;[string][18]>** 
 
 ### grabElementBoundingRect
 
@@ -1192,14 +1241,16 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 -   `prop`  
--   `elementSize` **[string][17]?** x, y, width or height of the given element.
+-   `elementSize` **[string][18]?** x, y, width or height of the given element.
 
-Returns **([Promise][25]&lt;DOMRect> | [Promise][25]&lt;[number][22]>)** Element bounding rectangle
+Returns **([Promise][26]&lt;DOMRect> | [Promise][26]&lt;[number][23]>)** Element bounding rectangle
 
 ### grabGeoLocation
 
+This method is **deprecated**.
+
 Return the current geo location 
 Resumes test execution, so **should be used inside async function with `await`** operator.
 
@@ -1207,7 +1258,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let geoLocation = await I.grabGeoLocation();
 ```
 
-Returns **[Promise][25]&lt;{latitude: [number][22], longitude: [number][22], altitude: [number][22]}>** 
+Returns **[Promise][26]&lt;{latitude: [number][23], longitude: [number][23], altitude: [number][23]}>** 
 
 ### grabHTMLFrom
 
@@ -1222,9 +1273,9 @@ let postHTML = await I.grabHTMLFrom('#post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `element` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** HTML code for an element
+Returns **[Promise][26]&lt;[string][18]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -1238,9 +1289,9 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `element` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** HTML code for an element
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -1251,7 +1302,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][25]&lt;[number][22]>** number of open tabs
+Returns **[Promise][26]&lt;[number][23]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -1264,9 +1315,9 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[number][22]>** number of visible elements
+Returns **[Promise][26]&lt;[number][23]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -1277,7 +1328,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][25]&lt;PageScrollPosition>** scroll position
+Returns **[Promise][26]&lt;PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -1287,7 +1338,7 @@ Grab the text within the popup. If no popup is visible then it will return null.
 await I.grabPopupText();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** 
+Returns **[Promise][26]&lt;[string][18]>** 
 
 ### grabSource
 
@@ -1298,7 +1349,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** source code
+Returns **[Promise][26]&lt;[string][18]>** source code
 
 ### grabTextFrom
 
@@ -1313,9 +1364,9 @@ If multiple elements found returns first element.
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][26]&lt;[string][18]>** attribute value
 
 ### grabTextFromAll
 
@@ -1328,9 +1379,9 @@ let pins = await I.grabTextFromAll('#pin li');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** attribute value
 
 ### grabTitle
 
@@ -1341,7 +1392,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** title
+Returns **[Promise][26]&lt;[string][18]>** title
 
 ### grabValueFrom
 
@@ -1355,9 +1406,9 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][26]&lt;[string][18]>** attribute value
 
 ### grabValueFromAll
 
@@ -1370,9 +1421,9 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][26]&lt;[Array][29]&lt;[string][18]>>** attribute value
 
 ### grabWebElements
 
@@ -1385,9 +1436,9 @@ const webElements = await I.grabWebElements('#button');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;any>** WebElement of being used Web helper
+Returns **[Promise][26]&lt;any>** WebElement of being used Web helper
 
 ### moveCursorTo
 
@@ -1401,11 +1452,11 @@ I.moveCursorTo('#submit', 5,5);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 -   `xOffset`  
 -   `yOffset`  
--   `offsetX` **[number][22]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][22]** (optional, `0` by default) Y-axis offset. 
+-   `offsetX` **[number][23]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][23]** (optional, `0` by default) Y-axis offset. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1430,7 +1481,7 @@ _Note:_ In case a text field or textarea is focused be aware that some browsers
 
 Presses a key in the browser (on a focused element).
 
-_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][30].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][31].
 
 ```js
 I.pressKey('Backspace');
@@ -1489,7 +1540,7 @@ Some of the supported key names are:
 
 #### Parameters
 
--   `key` **([string][17] | [Array][28]&lt;[string][17]>)** key or array of keys to press.
+-   `key` **([string][18] | [Array][29]&lt;[string][18]>)** key or array of keys to press.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1497,7 +1548,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Presses a key in the browser and leaves it in a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][31]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][32]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1507,7 +1558,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
--   `key` **[string][17]** name of key to press down.
+-   `key` **[string][18]** name of key to press down.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1515,7 +1566,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Releases a key in the browser which was previously set to a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][31]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][32]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1525,7 +1576,7 @@ I.pressKeyUp('Control');
 
 #### Parameters
 
--   `key` **[string][17]** name of key to release.
+-   `key` **[string][18]** name of key to release.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1548,8 +1599,8 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
--   `width` **[number][22]** width in pixels or `maximize`.
--   `height` **[number][22]** height in pixels.
+-   `width` **[number][23]** width in pixels or `maximize`.
+-   `height` **[number][23]** height in pixels.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1568,8 +1619,8 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** clickable element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+-   `locator` **([string][18] | [object][17])** clickable element located by CSS|XPath|strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1614,8 +1665,8 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `fileName` **[string][17]** file name to save.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `fileName` **[string][18]** file name to save.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1632,8 +1683,8 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 
 #### Parameters
 
--   `fileName` **[string][17]** file name to save.
--   `fullPage` **[boolean][32]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+-   `fileName` **[string][18]** file name to save.
+-   `fullPage` **[boolean][33]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1649,8 +1700,8 @@ I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "cent
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `scrollIntoViewOptions` **(ScrollIntoViewOptions | [boolean][32])** either alignToTop=true|false or scrollIntoViewOptions. See [https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView][33].
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
+-   `scrollIntoViewOptions` **(ScrollIntoViewOptions | [boolean][33])** either alignToTop=true|false or scrollIntoViewOptions. See [https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView][34].
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1686,9 +1737,9 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `offsetX` **[number][22]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][22]** (optional, `0` by default) Y-axis offset. 
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
+-   `offsetX` **[number][23]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][23]** (optional, `0` by default) Y-axis offset. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1705,8 +1756,8 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
--   `text` **[string][17]** expected on page.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
+-   `text` **[string][18]** expected on page.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1724,8 +1775,8 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `attributes` **[object][16]** attributes and their values to check.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
+-   `attributes` **[object][17]** attributes and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1742,7 +1793,7 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1756,7 +1807,7 @@ I.seeCookie('Auth');
 
 #### Parameters
 
--   `name` **[string][17]** cookie name.
+-   `name` **[string][18]** cookie name.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1770,8 +1821,8 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `cssProperties` **[object][16]** object with CSS properties and their values to check.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
+-   `cssProperties` **[object][17]** object with CSS properties and their values to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1788,7 +1839,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 #### Parameters
 
--   `url` **[string][17]** value to check.
+-   `url` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1803,7 +1854,7 @@ I.seeElement('#modal');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** located by CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1822,7 +1873,7 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1836,7 +1887,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 #### Parameters
 
--   `url` **[string][17]** a fragment to check
+-   `url` **[string][18]** a fragment to check
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1854,8 +1905,8 @@ I.seeInField('#searchform input','Search');
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
--   `value` **([string][17] | [object][16])** value to check.
+-   `field` **([string][18] | [object][17])** located by label|name|CSS|XPath|strict locator.
+-   `value` **([string][18] | [object][17])** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1866,7 +1917,7 @@ given string.
 
 #### Parameters
 
--   `text` **[string][17]** value to check.
+-   `text` **[string][18]** value to check.
 
 ### seeInSource
 
@@ -1878,7 +1929,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
--   `text` **[string][17]** value to check.
+-   `text` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1892,7 +1943,7 @@ I.seeInTitle('Home Page');
 
 #### Parameters
 
--   `text` **[string][17]** text value to check.
+-   `text` **[string][18]** text value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1907,8 +1958,8 @@ I.seeNumberOfElements('#submitBtn', 1);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `num` **[number][23]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1927,8 +1978,8 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `num` **[number][23]** number of elements.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1946,8 +1997,8 @@ I.seeTextEquals('text', 'h1');
 
 #### Parameters
 
--   `text` **[string][17]** element value to check.
--   `context` **([string][17] | [object][16])?** element located by CSS|XPath|strict locator. 
+-   `text` **[string][18]** element value to check.
+-   `context` **([string][18] | [object][17])?** element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1961,7 +2012,7 @@ I.seeTitleEquals('Test title.');
 
 #### Parameters
 
--   `text` **[string][17]** value to check.
+-   `text` **[string][18]** value to check.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1988,14 +2039,14 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
--   `select` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
--   `option` **([string][17] | [Array][28]&lt;any>)** visible text or value of option.
+-   `select` **([string][18] | [object][17])** field located by label|name|CSS|XPath|strict locator.
+-   `option` **([string][18] | [Array][29]&lt;any>)** visible text or value of option.
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### setCookie
 
-Uses Selenium's JSON [cookie format][34].
+Uses Selenium's JSON [cookie format][35].
 Sets cookie(s).
 
 Can be a single cookie object or an array of cookies:
@@ -2012,12 +2063,14 @@ I.setCookie([
 
 #### Parameters
 
--   `cookie` **(Cookie | [Array][28]&lt;Cookie>)** a cookie object or array of cookie objects.
+-   `cookie` **(Cookie | [Array][29]&lt;Cookie>)** a cookie object or array of cookie objects.
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### setGeoLocation
 
+This method is **deprecated**.
+
 Set the current geo location
 
 ```js
@@ -2027,9 +2080,9 @@ I.setGeoLocation(121.21, 11.56, 10);
 
 #### Parameters
 
--   `latitude` **[number][22]** to set.
--   `longitude` **[number][22]** to set
--   `altitude` **[number][22]?** (optional, null by default) to set 
+-   `latitude` **[number][23]** to set.
+-   `longitude` **[number][23]** to set
+-   `altitude` **[number][23]?** (optional, null by default) to set
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2044,7 +2097,7 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
--   `locator` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+-   `locator` **([string][18]? | [object][17])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2059,8 +2112,8 @@ I.switchToNextTab(2);
 
 #### Parameters
 
--   `num` **[number][22]?** (optional) number of tabs to switch forward, default: 1. 
--   `sec` **([number][22] | null)?** (optional) time in seconds to wait. 
+-   `num` **[number][23]?** (optional) number of tabs to switch forward, default: 1. 
+-   `sec` **([number][23] | null)?** (optional) time in seconds to wait. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2075,8 +2128,8 @@ I.switchToPreviousTab(2);
 
 #### Parameters
 
--   `num` **[number][22]?** (optional) number of tabs to switch backward, default: 1. 
--   `sec` **[number][22]??** (optional) time in seconds to wait. 
+-   `num` **[number][23]?** (optional) number of tabs to switch backward, default: 1. 
+-   `sec` **[number][23]??** (optional) time in seconds to wait. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2096,13 +2149,13 @@ await I.switchToWindow( window );
 
 #### Parameters
 
--   `window` **[string][17]** name of window handle.
+-   `window` **[string][18]** name of window handle.
 
 ### 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`][30] is not an option.
+_Note:_ Should be used when [`fillField`][31] is not an option.
 
 ```js
 // passing in a string
@@ -2121,8 +2174,8 @@ I.type(secret('123456'));
 #### Parameters
 
 -   `keys`  
--   `delay` **[number][22]?** (optional) delay in ms between key presses 
--   `key` **([string][17] | [Array][28]&lt;[string][17]>)** or array of keys to type.
+-   `delay` **[number][23]?** (optional) delay in ms between key presses 
+-   `key` **([string][18] | [Array][29]&lt;[string][18]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2142,19 +2195,19 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+-   `field` **([string][18] | [object][17])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][18]? | [object][17])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
 ### useWebDriverTo
 
-Use [webdriverio][35] API inside a test.
+Use [webdriverio][36] API inside a test.
 
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`browser`][35]) } object from WebDriver API is available.
+{ [`browser`][36]) } object from WebDriver API is available.
 
 ```js
 I.useWebDriverTo('open multiple windows', async ({ browser }) {
@@ -2165,8 +2218,8 @@ I.useWebDriverTo('open multiple windows', async ({ browser }) {
 
 #### Parameters
 
--   `description` **[string][17]** used to show in logs.
--   `fn` **[function][24]** async functuion that executed with WebDriver helper as argument
+-   `description` **[string][18]** used to show in logs.
+-   `fn` **[function][25]** async functuion that executed with WebDriver helper as argument
 
 ### wait
 
@@ -2178,7 +2231,7 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
--   `sec` **[number][22]** number of second to wait.
+-   `sec` **[number][23]** number of second to wait.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2194,9 +2247,9 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
 -   `waitTimeout`  
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2211,8 +2264,8 @@ I.waitForDetached('#popup');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2228,8 +2281,8 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2240,8 +2293,8 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional) time in seconds to wait, 1 by default. 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]** (optional) time in seconds to wait, 1 by default. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2262,9 +2315,9 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][17] | [function][24])** to be executed in browser context.
--   `argsOrSec` **([Array][28]&lt;any> | [number][22])?** (optional, `1` by default) arguments for function or seconds. 
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait 
+-   `fn` **([string][18] | [function][25])** to be executed in browser context.
+-   `argsOrSec` **([Array][29]&lt;any> | [number][23])?** (optional, `1` by default) arguments for function or seconds. 
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2279,8 +2332,23 @@ I.waitForInvisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForNumberOfTabs
+
+Waits for number of tabs.
+
+```js
+I.waitForNumberOfTabs(2);
+```
+
+#### Parameters
+
+-   `expectedTabs` **[number][23]** expecting the number of tabs.
+-   `sec` **[number][23]** number of secs to wait.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2297,9 +2365,9 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
--   `text` **[string][17]** to wait for.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
--   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator. 
+-   `text` **[string][18]** to wait for.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+-   `context` **([string][18] | [object][17])?** (optional) element located by CSS|XPath|strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2313,9 +2381,9 @@ I.waitForValue('//input', "GoodValue");
 
 #### Parameters
 
--   `field` **([string][17] | [object][16])** input field.
--   `value` **[string][17]** expected value.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `field` **([string][18] | [object][17])** input field.
+-   `value` **[string][18]** expected value.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2330,8 +2398,8 @@ I.waitForVisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2345,8 +2413,8 @@ I.waitInUrl('/info', 2);
 
 #### Parameters
 
--   `urlPart` **[string][17]** value to check.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `urlPart` **[string][18]** value to check.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2360,9 +2428,9 @@ I.waitNumberOfVisibleElements('a', 3);
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `num` **[number][23]** number of elements.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2377,8 +2445,8 @@ I.waitToHide('#popup');
 
 #### Parameters
 
--   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `locator` **([string][18] | [object][17])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2393,8 +2461,8 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 #### Parameters
 
--   `urlPart` **[string][17]** value to check.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
+-   `urlPart` **[string][18]** value to check.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2402,72 +2470,78 @@ Returns **void** automatically synchronized promise through #recorder
 
 [2]: https://codecept.io/webdriver/#testing-with-webdriver
 
-[3]: http://webdriver.io/guide/getstarted/configuration.html
+[3]: https://webdriver.io/blog/2023/07/31/driver-management/
+
+[4]: http://webdriver.io/guide/getstarted/configuration.html
+
+[5]: https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/IE/Options.html
+
+[6]: https://aerokube.com/selenoid/latest/
 
-[4]: https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/IE/Options.html
+[7]: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities
 
-[5]: https://aerokube.com/selenoid/latest/
+[8]: http://webdriver.io/guide/usage/cloudservices.html
 
-[6]: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities
+[9]: https://webdriver.io/docs/sauce-service.html
 
-[7]: http://webdriver.io/guide/usage/cloudservices.html
+[10]: https://github.com/puneet0191/codeceptjs-saucehelper/
 
-[8]: https://webdriver.io/docs/sauce-service.html
+[11]: https://webdriver.io/docs/browserstack-service.html
 
-[9]: https://github.com/puneet0191/codeceptjs-saucehelper/
+[12]: https://github.com/PeterNgTr/codeceptjs-bshelper
 
-[10]: https://webdriver.io/docs/browserstack-service.html
+[13]: https://github.com/testingbot/codeceptjs-tbhelper
 
-[11]: https://github.com/PeterNgTr/codeceptjs-bshelper
+[14]: https://webdriver.io/docs/testingbot-service.html
 
-[12]: https://github.com/testingbot/codeceptjs-tbhelper
+[15]: https://github.com/PeterNgTr/codeceptjs-applitoolshelper
 
-[13]: https://webdriver.io/docs/testingbot-service.html
+[16]: http://webdriver.io/guide/usage/multiremote.html
 
-[14]: https://github.com/PeterNgTr/codeceptjs-applitoolshelper
+[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
 
-[15]: http://webdriver.io/guide/usage/multiremote.html
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[16]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[19]: http://jster.net/category/windows-modals-popups
 
-[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[20]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
 
-[18]: http://jster.net/category/windows-modals-popups
+[21]: https://playwright.dev/docs/api/class-locator#locator-blur
 
-[19]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
+[22]: https://webdriver.io/docs/timeouts.html
 
-[20]: https://playwright.dev/docs/api/class-locator#locator-blur
+[23]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[21]: https://webdriver.io/docs/timeouts.html
+[24]: https://vuejs.org/v2/api/#Vue-nextTick
 
-[22]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[23]: https://vuejs.org/v2/api/#Vue-nextTick
+[26]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[24]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[27]: http://webdriver.io/api/protocol/execute.html
 
-[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[28]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[26]: http://webdriver.io/api/protocol/execute.html
+[29]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[27]: https://playwright.dev/docs/api/class-locator#locator-focus
+[30]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined
 
-[28]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[31]: #fillfield
 
-[29]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined
+[32]: #click
 
-[30]: #fillfield
+[33]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[31]: #click
+[34]: https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView
 
-[32]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[35]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object
 
-[33]: https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView
+[36]: https://webdriver.io/docs/api.html
 
-[34]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object
+[37]: http://codecept.io/acceptance/#smartwait
 
-[35]: https://webdriver.io/docs/api.html
+[38]: http://webdriver.io/docs/timeouts.html
 
-[36]: http://codecept.io/acceptance/#smartwait
+[39]: https://webdriver.io/docs/configuration/#loglevel
 
-[37]: http://webdriver.io/docs/timeouts.html
+[40]: https://webdriver.io/docs/automationProtocols/#devtools-protocol