codeceptjs 2.1.3 → 2.2.1

package/docs/helpers/WebDriver.md

@@ -2,11 +2,12 @@
 id: WebDriver
 title: WebDriver
 ---
+
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
 ## WebDriver
 
-**Extends Helper**
+Extends Helper
 
 WebDriver helper which wraps [webdriverio][1] library to
 manipulate browser using Selenium WebDriver or PhantomJS.
@@ -19,37 +20,37 @@ This helper should be configured in codecept.json or codecept.conf.js
 
 -   `url`: base url of website to be tested.
 -   `browser`: browser in which to perform testing.
--   `host`: (optional, default: localhost) - WebDriver host to connect.
--   `port`: (optional, default: 4444) - WebDriver port to connect.
--   `protocol`: (optional, default: http) - protocol for WebDriver server.
--   `path`: (optional, default: /wd/hub) - path to WebDriver server,
--   `remoteFileUpload`: (optional, default: true) - upload file to remote server when running `attachFile`.
--   `restart`: (optional, default: true) - restart browser between tests.
--   `smartWait`: (optional) **enables [SmartWait][3]**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
--   `disableScreenshots`: (optional, default: false) - don't save screenshots on failure.
--   `fullPageScreenshots` (optional, default: false) - make full page screenshots on failure.
--   `uniqueScreenshotNames`: (optional, default: false) - option to prevent screenshot override if you have scenarios with the same name in different suites.
--   `keepBrowserState`: (optional, default: false) - keep browser state between tests when `restart` is set to false.
--   `keepCookies`: (optional, default: false) - keep cookies between tests when `restart` set to false.
+-   `host`:  - WebDriver host to connect.
+-   `port`:  - WebDriver port to connect.
+-   `protocol`:  - protocol for WebDriver server.
+-   `path`:  - path to WebDriver server,
+-   `remoteFileUpload`:  - upload file to remote server when running `attachFile`.
+-   `restart`:  - restart browser between tests.
+-   `smartWait`: (optional) enables [SmartWait][3]; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
+-   `disableScreenshots`:  - don't save screenshots on failure.
+-   `fullPageScreenshots`  - make full page screenshots on failure.
+-   `uniqueScreenshotNames`:  - option to prevent screenshot override if you have scenarios with the same name in different suites.
+-   `keepBrowserState`:  - keep browser state between tests when `restart` is set to false.
+-   `keepCookies`:  - keep cookies between tests when `restart` set to false.
 -   `windowSize`: (optional) default window size. Set to `maximize` or a dimension in the format `640x480`.
--   `waitForTimeout`: (optional, default: 1000) sets default wait time in _ms_ for all `wait*` functions.
+-   `waitForTimeout`:  sets default wait time in _ms_ for all `wait` functions.
 -   `desiredCapabilities`: Selenium's [desired
     capabilities][4].
--   `manualStart`: (optional, default: false) - do not start browser before a test, start it manually inside a helper
+-   `manualStart`:  - do not start browser before a test, start it manually inside a helper
     with `this.helpers["WebDriver"]._startBrowser()`.
 -   `timeouts`: [WebDriver timeouts][5] defined as hash.
 
 Example:
 
-```json
+```js
 {
-   "helpers": {
-     "WebDriver" : {
-       "smartWait": 5000,
-       "browser": "chrome",
-       "restart": false,
-       "windowSize": "maximize",
-       "timeouts": {
+   helpers: {
+     WebDriver : {
+       smartWait: 5000,
+       browser: "chrome",
+       restart: false,
+       windowSize: "maximize",
+       timeouts: {
          "script": 60000,
          "page load": 10000
        }
@@ -63,15 +64,15 @@ website][6].
 
 ### Headless Chrome
 
-```json
+```js
 {
-   "helpers": {
-     "WebDriver" : {
-       "url": "http://localhost",
-       "browser": "chrome",
-       "desiredCapabilities": {
-         "chromeOptions": {
-           "args": [ "--headless", "--disable-gpu", "--window-size=800,600" ]
+   helpers: {
+     WebDriver : {
+       url: "http://localhost",
+       browser: "chrome",
+       desiredCapabilities: {
+         chromeOptions: {
+           args: [ "--headless", "--disable-gpu", "--window-size=800,600" ]
          }
        }
      }
@@ -83,14 +84,14 @@ website][6].
 
 Additional configuration params can be used from [IE options][7]
 
-```json
+```js
 {
-   "helpers": {
-     "WebDriver" : {
-       "url": "http://localhost",
-       "browser": "internet explorer",
-       "desiredCapabilities": {
-         "ieOptions": {
+   helpers: {
+     WebDriver : {
+       url: "http://localhost",
+       browser: "internet explorer",
+       desiredCapabilities: {
+         ieOptions: {
            "ie.browserCommandLineSwitches": "-private",
            "ie.usePerProcessProxy": true,
            "ie.ensureCleanSession": true,
@@ -103,15 +104,18 @@ Additional configuration params can be used from [IE options][7]
 
 ### Selenoid Options
 
-```json
+[Selenoid][8] 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
 {
-   "helpers": {
-     "WebDriver" : {
-       "url": "http://localhost",
-       "browser": "chrome",
-       "desiredCapabilities": {
-         "selenoidOptions": {
-           "enableVNC": true,
+   helpers: {
+     WebDriver : {
+       url: "http://localhost",
+       browser: "chrome",
+       desiredCapabilities: {
+         selenoidOptions: {
+           enableVNC: true,
          }
        }
      }
@@ -119,17 +123,17 @@ Additional configuration params can be used from [IE options][7]
 }
 ```
 
-### Connect through proxy
+### Connect Through proxy
 
 CodeceptJS also provides flexible options when you want to execute tests to Selenium servers through proxy. You will
 need to update the `helpers.WebDriver.capabilities.proxy` key.
 
 ```js
 {
-    "helpers": {
-        "WebDriver": {
-            "capabilities": {
-                "proxy": {
+    helpers: {
+        WebDriver: {
+            capabilities: {
+                proxy: {
                     "proxyType": "manual|pac",
                     "proxyAutoconfigUrl": "URL TO PAC FILE",
                     "httpProxy": "PROXY SERVER",
@@ -150,10 +154,10 @@ For example,
 
 ```js
 {
-    "helpers": {
-        "WebDriver": {
-            "capabilities": {
-                "proxy": {
+    helpers: {
+        WebDriver: {
+            capabilities: {
+                proxy: {
                     "proxyType": "manual",
                     "httpProxy": "http://corporate.proxy:8080",
                     "socksUsername": "codeceptjs",
@@ -172,7 +176,7 @@ information.
 ### Cloud Providers
 
 WebDriver makes it possible to execute tests against services like `Sauce Labs` `BrowserStack` `TestingBot`
-Check out their documentation on [available parameters][8]
+Check out their documentation on [available parameters][9]
 
 Connecting to `BrowserStack` and `Sauce Labs` is simple. All you need to do
 is set the `user` and `key` parameters. WebDriver automatically know which
@@ -180,12 +184,12 @@ service provider to connect to.
 
 ```js
 {
-    "helpers":{
-        "WebDriver": {
-            "url": "YOUR_DESIRED_HOST",
-            "user": "YOUR_BROWSERSTACK_USER",
-            "key": "YOUR_BROWSERSTACK_KEY",
-            "capabilities": {
+    helpers:{
+        WebDriver: {
+            url: "YOUR_DESIRED_HOST",
+            user: "YOUR_BROWSERSTACK_USER",
+            key: "YOUR_BROWSERSTACK_KEY",
+            capabilities: {
                 "browserName": "chrome",
 
                 // only set this if you're using BrowserStackLocal to test a local domain
@@ -221,9 +225,9 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][9].
+See [complete reference on webdriver.io][10].
 
-> Alternatively, use [codeceptjs-saucehelper][10] for better reporting.
+> Alternatively, use [codeceptjs-saucehelper][11] for better reporting.
 
 #### BrowserStack
 
@@ -247,13 +251,13 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][11].
+See [complete reference on webdriver.io][12].
 
-> Alternatively, use [codeceptjs-bshelper][12] for better reporting.
+> Alternatively, use [codeceptjs-bshelper][13] for better reporting.
 
 #### TestingBot
 
-> **Recommended**: use official [TestingBot Helper][13].
+> Recommended: use official [TestingBot Helper][14].
 
 Alternatively, TestingBot can be configured via wdio service, which should be installed additionally:
 
@@ -275,25 +279,25 @@ plugins: {
 }
 ```
 
-See [complete reference on webdriver.io][14].
+See [complete reference on webdriver.io][15].
 
 #### Applitools
 
 Visual testing via Applitools service
 
-> Use [CodeceptJS Applitools Helper][15] with Applitools wdio service.
+> Use [CodeceptJS Applitools Helper][16] 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][16] on the subject
+Here is the [webdriverio docs][17] on the subject
 
 ```js
 {
-    "helpers": {
-        "WebDriver": {
+    helpers: {
+        WebDriver: {
             "multiremote": {
                 "MyChrome": {
                     "desiredCapabilities": {
@@ -338,7 +342,7 @@ this.helpers['WebDriver']._locate({name: 'password'}).then //...
 #### Parameters
 
 -   `locator`  element located by CSS|XPath|strict locator.
--   `smartWait`   (optional, default `false`)
+-   `smartWait`   
 
 ### \_locateCheckable
 
@@ -380,9 +384,7 @@ this.helpers['WebDriver']._locateFields('Your email').then // ...
 
 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][17].
-
--   _Appium_: supported only for web testing
+libraries][18].
 
 ### amOnPage
 
@@ -397,7 +399,9 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
--   `url`  url path or global url.-   _Appium_: supported only for web testing
+-   `url` [string][19] url path or global url.
+    
+
 
 ### appendField
 
@@ -410,8 +414,15 @@ I.appendField('#myTextField', 'appended');
 
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator
--   `value`  text value to append.-   _Appium_: supported, but it's clear a field before insert in apps
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator
+-   `value` [string][19] text value to append.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### attachFile
 
@@ -426,16 +437,16 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 
 #### Parameters
 
--   `locator`  field located by label|name|CSS|XPath|strict locator.
--   `pathToFile`  local file path relative to codecept.json config file.
+-   `locator` ([string][19] \| [object][20]) field located by label|name|CSS|XPath|strict locator.
+-   `pathToFile` [string][19] local file path relative to codecept.json config file.
+    
+
     Appium: not tested
 
 ### cancelPopup
 
 Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
 
--   _Appium_: supported only for web testing
-
 ### checkOption
 
 Selects a checkbox or radio button.
@@ -451,9 +462,11 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
--   `field`  checkbox located by label | name | CSS | XPath | strict locator.
--   `context`  (optional) element located by CSS | XPath | strict locator.
-    Appium: not tested
+-   `field` ([string][19] \| [object][20]) checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` [string][19] (optional, `null` by default) element located by CSS | XPath | strict locator.
+    
+
+    Appium: not tested 
 
 ### clearCookie
 
@@ -467,7 +480,9 @@ I.clearCookie('test');
 
 #### Parameters
 
--   `cookie`  (optional) cookie name.-   _Appium_: supported only for web testing
+-   `cookie` [string][19] (optional, `null` by default) cookie name
+    
+
 
 ### clearField
 
@@ -481,7 +496,10 @@ I.clearField('#email');
 
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.-   _Appium_: supported
+-   `field`  
+-   `editable` ([string][19] \| [object][20]) field located by label|name|CSS|XPath|strict locator.
+    
+
 
 ### click
 
@@ -500,7 +518,7 @@ I.click('Submit');
 // CSS button
 I.click('#form input[type=submit]');
 // XPath
-I.click('//form/*[@type=submit]');
+I.click('//form/[@type=submit]');
 // link in context
 I.click('Logout', '#nav');
 // using strict locator
@@ -509,8 +527,14 @@ I.click({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator`  clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context`  (optional) element to search in CSS|XPath|Strict locator.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` ([string][19] \| [object][20]) (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    
+
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+ 
 
 ### closeCurrentTab
 
@@ -524,18 +548,15 @@ I.closeCurrentTab();
 
 Close all tabs except for the current one.
 
--   _Appium_: supported web test
-
 ```js
 I.closeOtherTabs();
 ```
 
 ### defineTimeout
 
-Set [WebDriver timeouts][18] in realtime.
+Set [WebDriver timeouts][21] in realtime.
 
--   _Appium_: supported only for web testing.
-    Timeouts are expected to be passed as object:
+Timeouts are expected to be passed as object:
 
 ```js
 I.defineTimeout({ script: 5000 });
@@ -552,55 +573,99 @@ Opposite to `see`. Checks that a text is not present on a page.
 Use context parameter to narrow down the search.
 
 ```js
-I.dontSee('Login'); // assume we are already logged in
+I.dontSee('Login'); // assume we are already logged in.
+I.dontSee('Login', '.nav'); // no login inside .nav element
 ```
 
 #### Parameters
 
--   `text`  is not present.
--   `context`  (optional) element located by CSS|XPath|strict locator in which to perfrom search.-   _Appium_: supported with context in apps
+-   `text` [string][19] which is not present.
+-   `context` ([string][19] \| [object][20]) (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+ 
 
 ### dontSeeCheckboxIsChecked
 
 Verifies that the specified checkbox is not checked.
 
+```js
+I.dontSeeeCheckboxIsChedcked('#agree'); // located by ID
+I.dontSeeeCheckboxIsChedcked('I agree to terms'); // located by label
+I.dontSeeeCheckboxIsChedcked('agree'); // located by name
+```
+
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+    
+
     Appium: not tested
 
 ### dontSeeCookie
 
 Checks that cookie with given name does not exist.
 
+```js
+I.dontSeeCookie('auth'); // no auth cookie
+```
+
 #### Parameters
 
--   `name`  cookie name.-   _Appium_: supported only for web testing
+-   `name` [string][19] cookie name.
+    
+
 
 ### dontSeeCurrentUrlEquals
 
 Checks that current url is not equal to provided one.
 If a relative url provided, a configured url will be prepended to it.
 
+```js
+I.dontSeeCurrentUrlEquals('/login'); // relative url are ok
+I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
+```
+
 #### Parameters
 
--   `url`  value to check.-   _Appium_: supported only for web testing
+-   `url` [string][19] value to check.
+    
+
 
 ### dontSeeElement
 
 Opposite to `seeElement`. Checks that element is not visible (or in DOM)
 
+```js
+I.dontSeeElement('.modal'); // modal is not shown
+```
+
 #### Parameters
 
--   `locator`  located by CSS|XPath|Strict locator.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|Strict locator.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### dontSeeElementInDOM
 
 Opposite to `seeElementInDOM`. Checks that element is not on page.
 
+```js
+I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
+```
+
 #### Parameters
 
--   `locator`  located by CSS|XPath|Strict locator.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|Strict locator.
+    
+
 
 ### dontSeeInCurrentUrl
 
@@ -608,33 +673,55 @@ Checks that current url does not contain a provided fragment.
 
 #### Parameters
 
--   `url`  value to check.-   _Appium_: supported only for web testing
+-   `url` [string][19] value to check.
+    
+
 
 ### dontSeeInField
 
 Checks that value of input field or textare doesn't equal to given value
 Opposite to `seeInField`.
 
+```js
+I.dontSeeInField('email', 'user@user.com'); // field by name
+I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
+```
+
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.
--   `value`  value to check.-   _Appium_: supported only for web testing
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+-   `value` [string][19] value to check.
+    
+
 
 ### dontSeeInSource
 
 Checks that the current page does not contains the given string in its raw source code.
 
+```js
+I.dontSeeInSource('<!--'); // no comments in source
+```
+
 #### Parameters
 
--   `text`  value to check.-   _Appium_: supported
+-   `text`  
+-   `value` [string][19] to check.
+    
+
 
 ### dontSeeInTitle
 
 Checks that title does not contain text.
 
+```js
+I.dontSeeInTitle('Error');
+```
+
 #### Parameters
 
--   `text`  text value to check.-   _Appium_: supported only for web testing
+-   `text` [string][19] value to check.
+    
+
 
 ### doubleClick
 
@@ -650,8 +737,14 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
--   `locator`  clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context`  (optional) element to search in CSS|XPath|Strict locator.-   _Appium_: supported only for web testing
+-   `locator` ([string][19] \| [object][20]) clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` ([string][19] \| [object][20]) (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    
+
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+ 
 
 ### dragAndDrop
 
@@ -663,8 +756,10 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
--   `srcElement`  located by CSS|XPath|strict locator.
--   `destElement`  located by CSS|XPath|strict locator.
+-   `srcElement` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+-   `destElement` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+    
+
     Appium: not tested
 
 ### dragSlider
@@ -679,19 +774,21 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
--   `locator`  located by label|name|CSS|XPath|strict locator.
--   `offsetX`  position to drag.
+-   `locator` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+-   `offsetX` [number][22] position to drag.
+    
+ 
 
 ### executeAsyncScript
 
 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][19].
+Example: In Vue.js to make components completely rendered we are waiting for [nextTick][23].
 
 ```js
 I.executeAsyncScript(function(done) {
-Vue.nextTick(done); // waiting for next tick
+  Vue.nextTick(done); // waiting for next tick
 });
 ```
 
@@ -700,14 +797,14 @@ Additional arguments can be passed as well, while `done` function is always last
 
 ```js
 let val = await I.executeAsyncScript(function(url, done) {
-// in browser context
-$.ajax(url, { success: (data) => done(data); }
+  // in browser context
+  $.ajax(url, { success: (data) => done(data); }
 }, 'http://ajax.callback.url/');
 ```
 
 #### Parameters
 
--   `fn`  function to be executed in browser context.
+-   `fn` ([string][19] \| [function][24]) function to be executed in browser context.
 
 ### executeScript
 
@@ -721,8 +818,8 @@ Example with jQuery DatePicker:
 ```js
 // change date of jQuery DatePicker
 I.executeScript(function() {
-// now we are inside browser context
-$('date').datetimepicker('setDate', new Date());
+  // now we are inside browser context
+  $('date').datetimepicker('setDate', new Date());
 });
 ```
 
@@ -730,14 +827,14 @@ Can return values. Don't forget to use `await` to get them.
 
 ```js
 let date = await I.executeScript(function(el) {
-// only basic types can be returned
-return $(el).datetimepicker('getDate').toString();
+  // only basic types can be returned
+  return $(el).datetimepicker('getDate').toString();
 }, '#date'); // passing jquery selector
 ```
 
 #### Parameters
 
--   `fn`  function to be executed in browser context.
+-   `fn` ([string][19] \| [function][24]) function to be executed in browser context.
 
 ### fillField
 
@@ -757,14 +854,30 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.
--   `value`  text value to fill.-   _Appium_: supported
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+-   `value` [string][19] text value to fill.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
+
+### grabAllWindowHandles
+
+Get all Window Handles.
+Useful for referencing a specific handle when calling `I.switchToWindow(handle)`
+
+```js
+const windows = await I.grabAllWindowHandles();
+```
 
 ### grabAttributeFrom
 
 Retrieves an attribute from an element located by CSS or XPath and returns it to test.
 An array as a result will be returned if there are more than one matched element.
-Resumes test execution, so **should be used inside async with `await`** operator.
+Resumes test execution, so should be used inside async with `await` operator.
 
 ```js
 let hint = await I.grabAttributeFrom('#tooltip', 'title');
@@ -772,9 +885,13 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `attr`  attribute name.
-    Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `attr` [string][19] attribute name.
+
+Returns [Promise][25]&lt;[string][19]> attribute value
+
+
+Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
 
 ### grabBrowserLogs
 
@@ -789,7 +906,8 @@ console.log(JSON.stringify(logs))
 
 Gets a cookie object by name.
 If none provided gets all cookies.
-Resumes test execution, so **should be used inside async with `await`** operator.
+
+-   Resumes test execution, so should be used inside async with `await` operator.
 
 ```js
 let cookie = await I.grabCookie('auth');
@@ -798,12 +916,16 @@ assert(cookie.value, '123456');
 
 #### Parameters
 
--   `name`  (optional) cookie name.-   _Appium_: supported only for web testing
+-   `name`  cookie name. 
+
+Returns [Promise][25]&lt;[string][19]> attribute value
+
+
 
 ### grabCssPropertyFrom
 
 Grab CSS property for given locator
-Resumes test execution, so **should be used inside an async function with `await`** operator.
+Resumes test execution, so should be used inside an async function with `await` operator.
 
 ```js
 const value = await I.grabCssPropertyFrom('h3', 'font-weight');
@@ -811,8 +933,12 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `cssProperty`  CSS property name.
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `cssProperty` [string][19] CSS property name.
+
+Returns [Promise][25]&lt;[string][19]> CSS value
+
+
 
 ### grabCurrentUrl
 
@@ -824,10 +950,23 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
+Returns [Promise][25]&lt;[string][19]> current URL
+
+
+
+### grabCurrentWindowHandle
+
+Get the current Window Handle.
+Useful for referencing it when calling `I.switchToWindow(handle)`
+
+```js
+const window = await I.grabCurrentWindowHandle();
+```
+
 ### grabHTMLFrom
 
 Retrieves the innerHTML from an element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside async function with `await`** operator.
+Resumes test execution, so should be used inside async function with `await` operator.
 If more than one element is found - an array of HTMLs returned.
 
 ```js
@@ -836,37 +975,53 @@ let postHTML = await I.grabHTMLFrom('#post');
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.-   _Appium_: supported only for web testing
+-   `locator`  element located by CSS|XPath|strict locator.
+
+Returns [Promise][25]&lt;[string][19]> HTML code for an element
+
+
 
 ### grabNumberOfOpenTabs
 
 Grab number of open tabs.
 
 ```js
-I.grabNumberOfOpenTabs();
+let tabs = await I.grabNumberOfOpenTabs();
 ```
 
+Returns [Promise][25]&lt;[number][22]> number of open tabs
+
+
+
 ### grabNumberOfVisibleElements
 
 Grab number of visible elements by locator.
 
 ```js
-I.grabNumberOfVisibleElements('p');
+let numOfElements = await I.grabNumberOfVisibleElements('p');
 ```
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+
+Returns [Promise][25]&lt;[number][22]> number of visible elements
+
+
 
 ### grabPageScrollPosition
 
 Retrieves a page scroll position and returns it to test.
-Resumes test execution, so **should be used inside an async function with `await`** operator.
+Resumes test execution, so should be used inside an async function with `await` operator.
 
 ```js
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
+Returns [Promise][25]&lt;[object][20]> scroll position
+
+
+
 ### grabPopupText
 
 Grab the text within the popup. If no popup is visible then it will return null.
@@ -884,12 +1039,14 @@ Resumes test execution, so should be used inside an async function.
 let pageSource = await I.grabSource();
 ```
 
--   _Appium_: supported
+Returns [Promise][25]&lt;[string][19]> source code
+
+
 
 ### grabTextFrom
 
 Retrieves a text from an element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside async with `await`** operator.
+Resumes test execution, so should be used inside async with `await` operator.
 
 ```js
 let pin = await I.grabTextFrom('#pin');
@@ -899,23 +1056,29 @@ If multiple elements found returns an array of texts.
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.-   _Appium_: supported
+-   `locator`  element located by CSS|XPath|strict locator.
+
+Returns [Promise][25]&lt;[string][19]> attribute value
+
+
 
 ### grabTitle
 
 Retrieves a page title and returns it to test.
-Resumes test execution, so **should be used inside async with `await`** operator.
+Resumes test execution, so should be used inside async with `await` operator.
 
 ```js
 let title = await I.grabTitle();
 ```
 
--   _Appium_: supported only for web testing
+Returns [Promise][25]&lt;[string][19]> title
+
+
 
 ### grabValueFrom
 
 Retrieves a value from a form element located by CSS or XPath and returns it to test.
-Resumes test execution, so **should be used inside async function with `await`** operator.
+Resumes test execution, so should be used inside async function with `await` operator.
 
 ```js
 let email = await I.grabValueFrom('input[name=email]');
@@ -923,7 +1086,11 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
--   `locator`  field located by label|name|CSS|XPath|strict locator.-   _Appium_: supported only for web testing
+-   `locator` ([string][19] \| [object][20]) field located by label|name|CSS|XPath|strict locator.
+
+Returns [Promise][25]&lt;[string][19]> attribute value
+
+
 
 ### moveCursorTo
 
@@ -937,9 +1104,11 @@ I.moveCursorTo('#submit', 5,5);
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.
--   `offsetX`  (optional) X-axis offset.
--   `offsetY`  (optional) Y-axis offset.-   _Appium_: supported only for web testing
+-   `locator` ([string][19] \| [object][20]) 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.
+    
+ 
 
 ### openNewTab
 
@@ -952,7 +1121,7 @@ I.openNewTab();
 ### pressKey
 
 Presses a key on a focused element.
-Special keys like 'Enter', 'Control', [etc][20]
+Special keys like 'Enter', 'Control', [etc][26]
 will be replaced with corresponding unicode.
 If modifier key is used (Control, Command, Alt, Shift) in array, it will be released afterwards.
 
@@ -963,36 +1132,43 @@ I.pressKey(['Control','a']);
 
 #### Parameters
 
--   `key`  key or array of keys to press.
-    [Valid key names][21] are:-   `'Add'`,
-    -   `'Alt'`,
-    -   `'ArrowDown'` or `'Down arrow'`,
-    -   `'ArrowLeft'` or `'Left arrow'`,
-    -   `'ArrowRight'` or `'Right arrow'`,
-    -   `'ArrowUp'` or `'Up arrow'`,
-    -   `'Backspace'`,
-    -   `'Command'`,
-    -   `'Control'`,
-    -   `'Del'`,
-    -   `'Divide'`,
-    -   `'End'`,
-    -   `'Enter'`,
-    -   `'Equals'`,
-    -   `'Escape'`,
-    -   `'F1 to F12'`,
-    -   `'Home'`,
-    -   `'Insert'`,
-    -   `'Meta'`,
-    -   `'Multiply'`,
-    -   `'Numpad 0'` to `'Numpad 9'`,
-    -   `'Pagedown'` or `'PageDown'`,
-    -   `'Pageup'` or `'PageUp'`,
-    -   `'Pause'`,
-    -   `'Semicolon'`,
-    -   `'Shift'`,
-    -   `'Space'`,
-    -   `'Subtract'`,
-    -   `'Tab'`.To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.-   _Appium_: supported, but clear field before pressing in apps:```js
+-   `key` ([string][19] \| [array][27]) key or array of keys to press.
+    
+
+    
+
+
+[Valid key names](https://w3c.github.io/webdriver/#keyboard-actions) are:
+
+- `'Add'`,
+- `'Alt'`,
+- `'ArrowDown'` or `'Down arrow'`,
+- `'ArrowLeft'` or `'Left arrow'`,
+- `'ArrowRight'` or `'Right arrow'`,
+- `'ArrowUp'` or `'Up arrow'`,
+- `'Backspace'`,
+- `'Command'`,
+- `'Control'`,
+- `'Del'`,
+- `'Divide'`,
+- `'End'`,
+- `'Enter'`,
+- `'Equals'`,
+- `'Escape'`,
+- `'F1 to F12'`,
+- `'Home'`,
+- `'Insert'`,
+- `'Meta'`,
+- `'Multiply'`,
+- `'Numpad 0'` to `'Numpad 9'`,
+- `'Pagedown'` or `'PageDown'`,
+- `'Pageup'` or `'PageUp'`,
+- `'Pause'`,
+- `'Semicolon'`,
+- `'Shift'`,
+- `'Space'`,
+- `'Subtract'`,
+- `'Tab'`.To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.```js
     I.pressKey('Control');
     I.click('#someelement');
     I.pressKey('Control');
@@ -1006,6 +1182,9 @@ Reload the current page.
 I.refreshPage();
 ```
 
+
+
+
 ### resizeWindow
 
 Resize the current window to provided width and height.
@@ -1013,8 +1192,10 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
--   `width`  width in pixels or `maximize`.
--   `height`  height in pixels.
+-   `width` [number][22] width in pixels or `maximize`.
+-   `height` [number][22] height in pixels.
+    
+
     Appium: not tested in web, in apps doesn't work
 
 ### rightClick
@@ -1032,8 +1213,14 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
--   `locator`  clickable element located by CSS|XPath|strict locator.
--   `context`  (optional) element located by CSS|XPath|strict locator.-   _Appium_: supported, but in apps works as usual click
+-   `locator` ([string][19] \| [object][20]) clickable element located by CSS|XPath|strict locator.
+-   `context` ([string][19] \| [object][20]) (optional, `null` by default) element located by CSS|XPath|strict locator.
+    
+
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### runInWeb
 
@@ -1064,7 +1251,7 @@ Placeholder for ~ locator only test case write once run on both Appium and WebDr
 ### saveScreenshot
 
 Saves a screenshot to ouput folder (set in codecept.json or codecept.conf.js).
-Filename is relative to output folder. 
+Filename is relative to output folder.
 Optionally resize the window to the full available page `scrollHeight` and `scrollWidth` to capture the entire page by passing `true` in as the second argument.
 
 ```js
@@ -1074,8 +1261,10 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 
 #### Parameters
 
--   `fileName`  file name to save.
--   `fullPage`  (optional) flag to enable fullscreen screenshot mode.-   _Appium_: supported
+-   `fileName` [string][19] file name to save.
+-   `fullPage` [boolean][28] (optional, `false` by default) flag to enable fullscreen screenshot mode.
+    
+ 
 
 ### scrollPageToBottom
 
@@ -1085,6 +1274,9 @@ Scroll page to the bottom.
 I.scrollPageToBottom();
 ```
 
+
+
+
 ### scrollPageToTop
 
 Scroll page to the top.
@@ -1093,21 +1285,8 @@ Scroll page to the top.
 I.scrollPageToTop();
 ```
 
-### scrollTo
-
-Scrolls to element matched by locator.
-Extra shift can be set with offsetX and offsetY options.
 
-```js
-I.scrollTo('footer');
-I.scrollTo('#submit', 5, 5);
-```
 
-#### Parameters
-
--   `locator`  located by CSS|XPath|strict locator.
--   `offsetX`  (optional) X-axis offset.
--   `offsetY`  (optional) Y-axis offset.-   _Appium_: supported only for web testing
 
 ### scrollTo
 
@@ -1121,9 +1300,11 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.
--   `offsetX`  (optional) X-axis offset.
--   `offsetY`  (optional) Y-axis offset.
+-   `locator` ([string][19] \| [object][20]) 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.
+    
+ 
 
 ### see
 
@@ -1138,21 +1319,29 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
--   `text`  expected on page.
--   `context`  (optional) element located by CSS|Xpath|strict locator in which to search for text.-   _Appium_: supported with context in apps
+-   `text` [string][19] expected on page.
+-   `context` ([string][19] \| [object][20]) (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+    
+
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+ 
 
 ### seeAttributesOnElements
 
 Checks that all elements with given locator have given attributes.
 
 ```js
-I.seeAttributesOnElements('//form', {'method': "post"});
+I.seeAttributesOnElements('//form', { method: "post"});
 ```
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.
--   `attributes`  object with attributes and their values to check.
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+-   `attributes` [object][20] attributes and their values to check.
+    
+
 
 ### seeCheckboxIsChecked
 
@@ -1166,7 +1355,9 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+    
+
     Appium: not tested
 
 ### seeCookie
@@ -1179,7 +1370,9 @@ I.seeCookie('Auth');
 
 #### Parameters
 
--   `name`  cookie name.-   _Appium_: supported only for web testing
+-   `name` [string][19] cookie name.
+    
+
 
 ### seeCssPropertiesOnElements
 
@@ -1191,8 +1384,10 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.
--   `cssProperties`  object with CSS properties and their values to check.
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+-   `cssProperties` [object][20] object with CSS properties and their values to check.
+    
+
 
 ### seeCurrentUrlEquals
 
@@ -1207,7 +1402,9 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 
 #### Parameters
 
--   `url`  value to check.-   _Appium_: supported only for web testing
+-   `url` [string][19] value to check.
+    
+
 
 ### seeElement
 
@@ -1220,7 +1417,14 @@ I.seeElement('#modal');
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) located by CSS|XPath|strict locator.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### seeElementInDOM
 
@@ -1233,7 +1437,9 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
--   `locator`  located by CSS|XPath|strict locator.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+    
+
 
 ### seeInCurrentUrl
 
@@ -1245,7 +1451,9 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 
 #### Parameters
 
--   `url`  value to check.-   _Appium_: supported only for web testing
+-   `url` [string][19] a fragment to check
+    
+
 
 ### seeInField
 
@@ -1261,16 +1469,16 @@ I.seeInField('#searchform input','Search');
 
 #### Parameters
 
--   `field`  located by label|name|CSS|XPath|strict locator.
--   `value`  value to check.-   _Appium_: supported only for web testing
+-   `field` ([string][19] \| [object][20]) located by label|name|CSS|XPath|strict locator.
+-   `value` [string][19] value to check.
+    
+
 
 ### seeInPopup
 
 Checks that the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`, contains the
 given string.
 
--   _Appium_: supported only for web testing
-
 #### Parameters
 
 -   `text`  value to check.
@@ -1285,31 +1493,44 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
--   `text`  value to check.-   _Appium_: supported
+-   `text` [string][19] value to check.
+    
+
 
 ### seeInTitle
 
 Checks that title contains text.
 
+```js
+I.seeInTitle('Home Page');
+```
+
 #### Parameters
 
--   `text`  text value to check.-   _Appium_: supported only for web testing
+-   `text` [string][19] text value to check.
+    
+
 
 ### seeNumberOfElements
 
 Asserts that an element appears a given number of times in the DOM.
 Element is located by label or name or CSS or XPath.
 
--   _Appium_: supported
-
 ```js
 I.seeNumberOfElements('#submitBtn', 1);
 ```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `num`  number of elements.
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `num` [number][22] number of elements.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### seeNumberOfVisibleElements
 
@@ -1322,8 +1543,15 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `num`  number of elements.
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `num` [number][22] number of elements.
+    
+
+    
+
+
+This action supports [React locators](https://codecept.io/react#locators)
+
 
 ### seeTextEquals
 
@@ -1373,8 +1601,10 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
--   `select`  field located by label|name|CSS|XPath|strict locator.
--   `option`  visible text or value of option.
+-   `select` ([string][19] \| [object][20]) field located by label|name|CSS|XPath|strict locator.
+-   `option` ([string][19] \| [array][27]) visible text or value of option.
+    
+
 
 ### setCookie
 
@@ -1386,16 +1616,25 @@ I.setCookie({name: 'auth', value: true});
 
 #### Parameters
 
--   `cookie`  cookie JSON object.-   _Appium_: supported only for web testingUses Selenium's JSON [cookie
-    format][22].
+-   `cookie` [object][20] a cookie object.
+    
+Uses Selenium's JSON [cookie
+    format][29].
 
 ### switchTo
 
 Switches frame or in case of null locator reverts to parent.
 
+```js
+I.switchTo('iframe'); // switch to first iframe
+I.switchTo(); // switch back to main page
+```
+
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.-   _Appium_: supported only for web testing
+-   `locator` ([string][19] \| [object][20]) (optional, `null` by default) element located by CSS|XPath|strict locator.
+    
+
 
 ### switchToNextTab
 
@@ -1425,6 +1664,24 @@ I.switchToPreviousTab(2);
 -   `num`  (optional) number of tabs to switch backward, default: 1.
 -   `sec`  (optional) time in seconds to wait.
 
+### switchToWindow
+
+Switch to the window with a specified handle.
+
+```js
+const windows = await I.grabAllWindowHandles();
+// ... do something
+await I.switchToWindow( windows[0] );
+
+const window = await.grabCurrentWindowHandle();
+// ... do something
+await I.switchToWindow( window );
+```
+
+#### Parameters
+
+-   `window`  
+
 ### uncheckOption
 
 Unselects a checkbox or radio button.
@@ -1440,9 +1697,11 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
--   `field`  checkbox located by label | name | CSS | XPath | strict locator.
--   `context`  (optional) element located by CSS | XPath | strict locator.
-    Appium: not tested
+-   `field` ([string][19] \| [object][20]) checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` [string][19] (optional, `null` by default) element located by CSS | XPath | strict locator.
+    
+
+    Appium: not tested 
 
 ### wait
 
@@ -1454,19 +1713,25 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
--   `sec`  time in seconds to wait.-   _Appium_: supported
+-   `sec` [number][22] number of second to wait.
+    
+
 
 ### waitForDetached
 
 Waits for an element to become not attached to the DOM on a page (by default waits for 1sec).
 Element can be located by CSS or XPath.
 
-    I.waitForDetached('#popup');
+```js
+I.waitForDetached('#popup');
+```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitForElement
 
@@ -1480,8 +1745,10 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitForEnabled
 
@@ -1490,8 +1757,10 @@ Element can be located by CSS or XPath.
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec`  (optional) time in seconds to wait, 1 by default.
+    
+
 
 ### waitForFunction
 
@@ -1510,21 +1779,27 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn`  to be executed in browser context.
--   `argsOrSec`  (optional) arguments for function or seconds.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `fn` ([string][19] \| [function][24]) to be executed in browser context.
+-   `argsOrSec` ([array][27] \| [number][22]) (optional, `1` by default) arguments for function or seconds. 
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitForInvisible
 
 Waits for an element to be removed or become invisible on a page (by default waits for 1sec).
 Element can be located by CSS or XPath.
 
-    I.waitForInvisible('#popup');
+```js
+I.waitForInvisible('#popup');
+```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitForText
 
@@ -1539,9 +1814,11 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
--   `text`  to wait for.
--   `sec`  (optional) time in seconds to wait.
--   `context`  (optional) element located by CSS|XPath|strict locator.
+-   `text` [string][19] to wait for.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait 
+-   `context` ([string][19] \| [object][20]) (optional) element located by CSS|XPath|strict locator.
+    
+ 
 
 ### waitForValue
 
@@ -1553,21 +1830,27 @@ I.waitForValue('//input', "GoodValue");
 
 #### Parameters
 
--   `field`  input field.
--   `value`  expected value.
--   `sec`  (optional) time in seconds to wait, 1 sec by default.
+-   `field` ([string][19] \| [object][20]) input field.
+-   `value` [string][19] expected value.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitForVisible
 
 Waits for an element to become visible on a page (by default waits for 1sec).
 Element can be located by CSS or XPath.
 
-    I.waitForVisible('#popup');
+```js
+I.waitForVisible('#popup');
+```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitInUrl
 
@@ -1579,8 +1862,10 @@ I.waitInUrl('/info', 2);
 
 #### Parameters
 
--   `urlPart`  value to check.
--   `sec`  (optional) time in seconds to wait.
+-   `urlPart` [string][19] value to check.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitNumberOfVisibleElements
 
@@ -1592,21 +1877,27 @@ I.waitNumberOfVisibleElements('a', 3);
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `num`  number of elements.
--   `sec`  (optional) time in seconds to wait.
+-   `locator` ([string][19] \| [object][20]) 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
+    
+ 
 
 ### waitToHide
 
 Waits for an element to hide (by default waits for 1sec).
 Element can be located by CSS or XPath.
 
-    I.waitToHide('#popup');
+```js
+I.waitToHide('#popup');
+```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
--   `sec`  (optional) time in seconds to wait, 1 by default.-   _Appium_: supported
+-   `locator` ([string][19] \| [object][20]) element located by CSS|XPath|strict locator.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 ### waitUntil
 
@@ -1619,10 +1910,12 @@ I.waitUntil(() => window.requests == 0, 5);
 
 #### Parameters
 
--   `fn`  function which is executed in browser context.
--   `sec`  (optional) time in seconds to wait, 1 by default.
--   `timeoutMsg`  (optional) message to show in case of timeout fail.
--   `interval`  (optional) time in seconds between condition checks.-   _Appium_: supported
+-   `fn` ([function][24] \| [string][19]) function which is executed in browser context.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait 
+-   `timeoutMsg` [string][19] message to show in case of timeout fail.
+    
+ 
+-   `interval`   
 
 ### waitUrlEquals
 
@@ -1635,8 +1928,10 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 #### Parameters
 
--   `urlPart`  value to check.
--   `sec`  (optional) time in seconds to wait.
+-   `urlPart` [string][19] value to check.
+-   `sec` [number][22] (optional, `1` by default) time in seconds to wait
+    
+ 
 
 [1]: http://webdriver.io/
 
@@ -1652,32 +1947,46 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [7]: https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/IE/Options.html
 
-[8]: http://webdriver.io/guide/usage/cloudservices.html
+[8]: https://aerokube.com/selenoid/latest/
+
+[9]: http://webdriver.io/guide/usage/cloudservices.html
+
+[10]: https://webdriver.io/docs/sauce-service.html
+
+[11]: https://github.com/puneet0191/codeceptjs-saucehelper/
+
+[12]: https://webdriver.io/docs/browserstack-service.html
+
+[13]: https://github.com/PeterNgTr/codeceptjs-bshelper
+
+[14]: https://github.com/testingbot/codeceptjs-tbhelper
+
+[15]: https://webdriver.io/docs/testingbot-service.html
 
-[9]: https://webdriver.io/docs/sauce-service.html
+[16]: https://github.com/PeterNgTr/codeceptjs-applitoolshelper
 
-[10]: https://github.com/puneet0191/codeceptjs-saucehelper/
+[17]: http://webdriver.io/guide/usage/multiremote.html
 
-[11]: https://webdriver.io/docs/browserstack-service.html
+[18]: http://jster.net/category/windows-modals-popups
 
-[12]: https://github.com/PeterNgTr/codeceptjs-bshelper
+[19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[13]: https://github.com/testingbot/codeceptjs-tbhelper
+[20]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
 
-[14]: https://webdriver.io/docs/testingbot-service.html
+[21]: https://webdriver.io/docs/timeouts.html
 
-[15]: https://github.com/PeterNgTr/codeceptjs-applitoolshelper
+[22]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[16]: http://webdriver.io/guide/usage/multiremote.html
+[23]: https://vuejs.org/v2/api/#Vue-nextTick
 
-[17]: http://jster.net/category/windows-modals-popups
+[24]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[18]: https://webdriver.io/docs/timeouts.html
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[19]: https://vuejs.org/v2/api/#Vue-nextTick
+[26]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#/session/:sessionId/element/:id/value
 
-[20]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#/session/:sessionId/element/:id/value
+[27]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[21]: https://w3c.github.io/webdriver/#keyboard-actions
+[28]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[22]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object
+[29]: https://code.google.com/p/selenium/wiki/JsonWireProtocol#Cookie_JSON_Object