codeceptjs 2.3.4 → 2.4.1

package/docs/helpers/Appium.md

@@ -1,13 +1,8 @@
----
-id: Appium
-title: Appium
----
-
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
 ## Appium
 
-Extends Webdriver
+**Extends Webdriver**
 
 Appium helper extends [Webriver][1] helper.
  It supports all browser methods and also includes special methods for mobile apps testing.
@@ -119,176 +114,199 @@ let browser = this.helpers['Appium'].browser
 
 -   `config`  
 
-### \_switchToContext
+### runOnIOS
 
-Switch to the specified context.
+Execute code only on iOS
 
-#### Parameters
+```js
+I.runOnIOS(() => {
+   I.click('//UIAApplication[1]/UIAWindow[1]/UIAButton[1]');
+   I.see('Hi, IOS', '~welcome');
+});
+```
 
--   `context`  the context to switch to
+Additional filter can be applied by checking for capabilities.
+For instance, this code will be executed only on iPhone 5s:
 
-### appendField
+```js
+I.runOnIOS({deviceName: 'iPhone 5s'},() => {
+   // ...
+});
+```
 
-Appends text to a input field or textarea.
-Field is located by name, label, CSS or XPath
+Also capabilities can be checked by a function.
 
 ```js
-I.appendField('#myTextField', 'appended');
+I.runOnAndroid((caps) => {
+   // caps is current config of desiredCapabiliites
+   return caps.platformVersion >= 6
+},() => {
+   // ...
+});
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator
--   `value` [string][4] text value to append.
-    
+-   `caps` **any** 
+-   `fn` **any** 
 
+### runOnAndroid
 
-### checkOption
+Execute code only on Android
 
-Selects a checkbox or radio button.
-Element is located by label or name or CSS or XPath.
+```js
+I.runOnAndroid(() => {
+   I.click('io.selendroid.testapp:id/buttonTest');
+});
+```
 
-The second parameter is a context (CSS or XPath locator) to narrow the search.
+Additional filter can be applied by checking for capabilities.
+For instance, this code will be executed only on Android 6.0:
 
 ```js
-I.checkOption('#agree');
-I.checkOption('I Agree to Terms and Conditions');
-I.checkOption('agree', '//form');
+I.runOnAndroid({platformVersion: '6.0'},() => {
+   // ...
+});
 ```
 
-#### Parameters
+Also capabilities can be checked by a function.
+In this case, code will be executed only on Android >= 6.
 
--   `field` ([string][4] \| [object][5]) checkbox located by label | name | CSS | XPath | strict locator.
--   `context` [string][4] (optional, `null` by default) element located by CSS | XPath | strict locator.
-    
+```js
+I.runOnAndroid((caps) => {
+   // caps is current config of desiredCapabiliites
+   return caps.platformVersion >= 6
+},() => {
+   // ...
+});
+```
 
+#### Parameters
 
-### click
+-   `caps` **any** 
+-   `fn` **any** 
 
-Perform a click on a link or a button, given by a locator.
-If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
-For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
-For images, the "alt" attribute and inner text of any parent links are searched.
+### runInWeb
 
-The second parameter is a context (CSS or XPath locator) to narrow the search.
+Execute code only in Web mode.
 
 ```js
-// simple link
-I.click('Logout');
-// button of form
-I.click('Submit');
-// CSS button
-I.click('#form input[type=submit]');
-// XPath
-I.click('//form/[@type=submit]');
-// link in context
-I.click('Logout', '#nav');
-// using strict locator
-I.click({css: 'nav a.login'});
+I.runInWeb(() => {
+   I.waitForElement('#data');
+   I.seeInCurrentUrl('/data');
+});
 ```
 
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` ([string][4] \| [object][5]) (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-    
+-   `fn` **any** 
 
+### seeAppIsInstalled
 
-### closeApp
-
-Close the given application.
+Check if an app is installed.
 
 ```js
-I.closeApp();
+I.seeAppIsInstalled("com.example.android.apis");
 ```
 
-Appium: support only iOS
+#### Parameters
 
-### dontSee
+-   `bundleId` **[string][4]** String  ID of bundled appAppium: support only Android
 
-Opposite to `see`. Checks that a text is not present on a page.
-Use context parameter to narrow down the search.
+### seeAppIsNotInstalled
+
+Check if an app is not installed.
 
 ```js
-I.dontSee('Login'); // assume we are already logged in.
-I.dontSee('Login', '.nav'); // no login inside .nav element
+I.seeAppIsNotInstalled("com.example.android.apis");
 ```
 
 #### Parameters
 
--   `text` [string][4] which is not present.
--   `context` ([string][4] \| [object][5]) (optional) element located by CSS|XPath|strict locator in which to perfrom search.
- 
+-   `bundleId` **[string][4]** String  ID of bundled appAppium: support only Android
 
-### dontSeeCheckboxIsChecked
+### installApp
 
-Verifies that the specified checkbox is not checked.
+Install an app on device.
 
 ```js
-I.dontSeeCheckboxIsChecked('#agree'); // located by ID
-I.dontSeeCheckboxIsChecked('I agree to terms'); // located by label
-I.dontSeeCheckboxIsChecked('agree'); // located by name
+I.installApp('/path/to/file.apk');
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator.
-    
+-   `path` **[string][4]** path to apk fileAppium: support only Android
 
+### removeApp
 
-### dontSeeElement
-
-Opposite to `seeElement`. Checks that element is not visible (or in DOM)
+Remove an app from the device.
 
 ```js
-I.dontSeeElement('.modal'); // modal is not shown
+I.removeApp('appName', 'com.example.android.apis');
 ```
 
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) located by CSS|XPath|Strict locator.
-    
-
+-   `appId` **[string][4]** 
+-   `bundleId` **[string][4]** String  ID of bundleAppium: support only Android
 
-### dontSeeInField
+### seeCurrentActivityIs
 
-Checks that value of input field or textarea doesn't equal to given value
-Opposite to `seeInField`.
+Check current activity on an Android device.
 
 ```js
-I.dontSeeInField('email', 'user@user.com'); // field by name
-I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
+I.seeCurrentActivityIs(".HomeScreenActivity")
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator.
--   `value` [string][4] value to check.
-    
+-   `currentActivity` **[string][4]** Appium: support only Android
 
+### seeDeviceIsLocked
 
-### fillField
+Check whether the device is locked.
 
-Fills a text field or textarea, after clearing its value, with the given string.
-Field is located by name, label, CSS, or XPath.
+```js
+I.seeDeviceIsLocked();
+```
+
+Appium: support only Android
+
+### seeDeviceIsUnlocked
+
+Check whether the device is not locked.
 
 ```js
-// by label
-I.fillField('Email', 'hello@world.com');
-// by name
-I.fillField('password', secret('123456'));
-// by CSS
-I.fillField('form#login input[name=username]', 'John');
-// or by strict locator
-I.fillField({css: 'form#login input[name=username]'}, 'John');
+I.seeDeviceIsUnlocked();
+```
+
+Appium: support only Android
+
+### seeOrientationIs
+
+Check the device orientation
+
+```js
+I.seeOrientationIs('PORTRAIT');
+I.seeOrientationIs('LANDSCAPE')
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator.
--   `value` [string][4] text value to fill.
-    
+-   `orientation` **(`"LANDSCAPE"` \| `"PORTRAIT"`)** LANDSCAPE or PORTRAITAppium: support Android and iOS
 
+### setOrientation
+
+Set a device orientation. Will fail, if app will not set orientation
+
+```js
+I.setOrientation('PORTRAIT');
+I.setOrientation('LANDSCAPE')
+```
+
+#### Parameters
+
+-   `orientation` **(`"LANDSCAPE"` \| `"PORTRAIT"`)** LANDSCAPE or PORTRAITAppium: support Android and iOS
 
 ### grabAllContexts
 
@@ -350,41 +368,97 @@ let settings = await I.grabSettings();
 
 Appium: support Android and iOS
 
-### grabTextFrom
+### \_switchToContext
 
-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.
+Switch to the specified context.
+
+#### Parameters
+
+-   `context` **any** the context to switch to
+
+### switchToWeb
+
+Switches to web context.
+If no context is provided switches to the first detected web context
 
 ```js
-let pin = await I.grabTextFrom('#pin');
+// switch to first web context
+I.switchToWeb();
+
+// or set the context explicitly
+I.switchToWeb('WEBVIEW_io.selendroid.testapp');
 ```
 
-If multiple elements found returns an array of texts.
+#### Parameters
+
+-   `context` **[string][4]?** 
+
+### switchToNative
+
+Switches to native context.
+By default switches to NATIVE_APP context unless other specified.
+
+```js
+I.switchToNative();
+
+// or set context explicitly
+I.switchToNative('SOME_OTHER_CONTEXT');
+```
 
 #### Parameters
 
--   `locator`  element located by CSS|XPath|strict locator.
+-   `context` **any**  (optional, default `null`)
+
+### startActivity
+
+Start an arbitrary Android activity during a session.
+
+```js
+I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
+```
+
+Appium: support only Android
 
-Returns [Promise][6]&lt;[string][4]> attribute value
+#### Parameters
 
+-   `appPackage`  
+-   `appActivity`  
 
+### setNetworkConnection
 
-### grabValueFrom
+Set network connection mode.
 
-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.
+-   airplane mode
+-   wifi mode
+-   data data
 
 ```js
-let email = await I.grabValueFrom('input[name=email]');
+I.setNetworkConnection(0) // airplane mode off, wifi off, data off
+I.setNetworkConnection(1) // airplane mode on, wifi off, data off
+I.setNetworkConnection(2) // airplane mode off, wifi on, data off
+I.setNetworkConnection(4) // airplane mode off, wifi off, data on
+I.setNetworkConnection(6) // airplane mode off, wifi on, data on
 ```
 
+See corresponding [webdriverio reference][5].
+
+Appium: support only Android
+
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) field located by label|name|CSS|XPath|strict locator.
+-   `value`  
+
+### setSettings
+
+Update the current setting on the device
 
-Returns [Promise][6]&lt;[string][4]> attribute value
+```js
+I.setSettings({cyberdelia: 'open'});
+```
 
+#### Parameters
 
+-   `settings` **[object][6]** objectAppium: support Android and iOS
 
 ### hideDeviceKeyboard
 
@@ -401,31 +475,42 @@ I.hideDeviceKeyboard('pressKey', 'Done');
 
 #### Parameters
 
--   `strategy`  desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)Appium: support Android and iOS
+-   `strategy` **(`"tapOutside"` \| `"pressKey"`)** desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)Appium: support Android and iOS
 -   `key`  
 
-### installApp
+### sendDeviceKeyEvent
 
-Install an app on device.
+Send a key event to the device.
+List of keys: [https://developer.android.com/reference/android/view/KeyEvent.html][7]
 
 ```js
-I.installApp('/path/to/file.apk');
+I.sendDeviceKeyEvent(3);
 ```
 
 #### Parameters
 
--   `path`  path to apk fileAppium: support only Android
+-   `keyValue` **[number][8]** Device specific key valueAppium: support only Android
 
-### makeTouchAction
+### openNotifications
 
-The Touch Action API provides the basis of all gestures that can be
-automated in Appium. At its core is the ability to chain together ad hoc
-individual actions, which will then be applied to an element in the
-application on the device.
-[See complete documentation][7]
+Open the notifications panel on the device.
 
 ```js
-I.makeTouchAction("~buttonStartWebviewCD", 'tap');
+I.openNotifications();
+```
+
+Appium: support only Android
+
+### makeTouchAction
+
+The Touch Action API provides the basis of all gestures that can be
+automated in Appium. At its core is the ability to chain together ad hoc
+individual actions, which will then be applied to an element in the
+application on the device.
+[See complete documentation][9]
+
+```js
+I.makeTouchAction("~buttonStartWebviewCD", 'tap');
 ```
 
 Appium: support Android and iOS
@@ -435,15 +520,37 @@ Appium: support Android and iOS
 -   `locator`  
 -   `action`  
 
-### openNotifications
+### tap
 
-Open the notifications panel on the device.
+Taps on element.
 
 ```js
-I.openNotifications();
+I.tap("~buttonStartWebviewCD");
 ```
 
-Appium: support only Android
+Shortcut for `makeTouchAction`
+
+#### Parameters
+
+-   `locator` **any** 
+
+### swipe
+
+Perform a swipe on the screen or an element.
+
+```js
+let locator = "#io.selendroid.testapp:id/LinearLayout1";
+I.swipe(locator, 800, 1200, 1000);
+```
+
+[See complete reference][10]
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** 
+-   `xoffset` **[number][8]** 
+-   `yoffset` **[number][8]** 
+-   `speed` **[number][8]** (optional), 1000 by defaultAppium: support Android and iOS (optional, default `1000`)
 
 ### performSwipe
 
@@ -455,8 +562,130 @@ I.performswipe(100,200);
 
 #### Parameters
 
--   `from`  
--   `to`  Appium: support Android and iOS
+-   `from` **[number][8]** 
+-   `to` **[number][8]** Appium: support Android and iOS
+
+### swipeDown
+
+Perform a swipe down on an element.
+
+```js
+let locator = "#io.selendroid.testapp:id/LinearLayout1";
+I.swipeDown(locator); // simple swipe
+I.swipeDown(locator, 500); // set speed
+I.swipeDown(locator, 1200, 1000); // set offset and speed
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** 
+-   `yoffset` **[number][8]?** (optional) (optional, default `1000`)
+-   `speed` **[number][8]** (optional), 1000 by defaultAppium: support Android and iOS (optional, default `1000`)
+
+### swipeLeft
+
+Perform a swipe left on an element.
+
+```js
+let locator = "#io.selendroid.testapp:id/LinearLayout1";
+I.swipeLeft(locator); // simple swipe
+I.swipeLeft(locator, 500); // set speed
+I.swipeLeft(locator, 1200, 1000); // set offset and speed
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** 
+-   `xoffset` **[number][8]?** (optional) (optional, default `1000`)
+-   `speed` **[number][8]** (optional), 1000 by defaultAppium: support Android and iOS (optional, default `1000`)
+
+### swipeRight
+
+Perform a swipe right on an element.
+
+```js
+let locator = "#io.selendroid.testapp:id/LinearLayout1";
+I.swipeRight(locator); // simple swipe
+I.swipeRight(locator, 500); // set speed
+I.swipeRight(locator, 1200, 1000); // set offset and speed
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** 
+-   `xoffset` **[number][8]?** (optional) (optional, default `1000`)
+-   `speed` **[number][8]** (optional), 1000 by defaultAppium: support Android and iOS (optional, default `1000`)
+
+### swipeUp
+
+Perform a swipe up on an element.
+
+```js
+let locator = "#io.selendroid.testapp:id/LinearLayout1";
+I.swipeUp(locator); // simple swipe
+I.swipeUp(locator, 500); // set speed
+I.swipeUp(locator, 1200, 1000); // set offset and speed
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** 
+-   `yoffset` **[number][8]?** (optional) (optional, default `1000`)
+-   `speed` **[number][8]** (optional), 1000 by defaultAppium: support Android and iOS (optional, default `1000`)
+
+### swipeTo
+
+Perform a swipe in selected direction on an element to searchable element.
+
+```js
+I.swipeTo(
+ "android.widget.CheckBox", // searchable element
+ "//android.widget.ScrollView/android.widget.LinearLayout", // scroll element
+  "up", // direction
+   30,
+   100,
+   500);
+```
+
+#### Parameters
+
+-   `searchableLocator` **[string][4]** 
+-   `scrollLocator` **[string][4]** 
+-   `direction` **[string][4]** 
+-   `timeout` **[number][8]** 
+-   `offset` **[number][8]** 
+-   `speed` **[number][8]** Appium: support Android and iOS
+
+### touchPerform
+
+Performs a specific touch action.
+The action object need to contain the action name, x/y coordinates
+
+```js
+I.touchPerform([{
+    action: 'press',
+    options: {
+      x: 100,
+      y: 200
+    }
+}, {action: 'release'}])
+
+I.touchPerform([{
+   action: 'tap',
+   options: {
+       element: '1', // json web element was queried before
+       x: 10,   // x offset
+       y: 20,   // y offset
+       count: 1 // number of touches
+   }
+}]);
+```
+
+Appium: support Android and iOS
+
+#### Parameters
+
+-   `actions`  
 
 ### pullFile
 
@@ -475,18 +704,15 @@ Appium: support Android and iOS
 -   `path`  
 -   `dest`  
 
-### removeApp
+### shakeDevice
 
-Remove an app from the device.
+Perform a shake action on the device.
 
 ```js
-I.removeApp('appName', 'com.example.android.apis');
+I.shakeDevice();
 ```
 
-#### Parameters
-
--   `appId`  
--   `bundleId`  String  ID of bundleAppium: support only Android
+Appium: support only iOS
 
 ### rotate
 
@@ -496,7 +722,7 @@ Perform a rotation gesture centered on the specified element.
 I.rotate(120, 120)
 ```
 
-See corresponding [webdriverio reference][8].
+See corresponding [webdriverio reference][11].
 
 Appium: support only iOS
 
@@ -509,92 +735,275 @@ Appium: support only iOS
 -   `rotation`  
 -   `touchCount`  
 
-### runInWeb
+### setImmediateValue
 
-Execute code only in Web mode.
+Set immediate value in app.
+
+See corresponding [webdriverio reference][12].
+
+Appium: support only iOS
+
+#### Parameters
+
+-   `id`  
+-   `value`  
+
+### simulateTouchId
+
+Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
 
 ```js
-I.runInWeb(() => {
-   I.waitForElement('#data');
-   I.seeInCurrentUrl('/data');
-});
+I.touchId(); // simulates valid fingerprint
+I.touchId(true); // simulates valid fingerprint
+I.touchId(false); // simulates invalid fingerprint
 ```
 
+Appium: support only iOS
+TODO: not tested
+
 #### Parameters
 
--   `fn` any 
+-   `match`  
 
-### runOnAndroid
+### closeApp
 
-Execute code only on Android
+Close the given application.
 
 ```js
-I.runOnAndroid(() => {
-   I.click('io.selendroid.testapp:id/buttonTest');
-});
+I.closeApp();
 ```
 
-Additional filter can be applied by checking for capabilities.
-For instance, this code will be executed only on Android 6.0:
+Appium: support only iOS
+
+### appendField
+
+Appends text to a input field or textarea.
+Field is located by name, label, CSS or XPath
 
 ```js
-I.runOnAndroid({platformVersion: '6.0'},() => {
-   // ...
-});
+I.appendField('#myTextField', 'appended');
 ```
 
-Also capabilities can be checked by a function.
-In this case, code will be executed only on Android >= 6.
+#### Parameters
+
+-   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator
+-   `value` **[string][4]** text value to append.
+
+### checkOption
+
+Selects a checkbox or radio button.
+Element is located by label or name or CSS or XPath.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
 
 ```js
-I.runOnAndroid((caps) => {
-   // caps is current config of desiredCapabiliites
-   return caps.platformVersion >= 6
-},() => {
-   // ...
-});
+I.checkOption('#agree');
+I.checkOption('I Agree to Terms and Conditions');
+I.checkOption('agree', '//form');
 ```
 
 #### Parameters
 
--   `caps` any 
--   `fn` any 
+-   `field` **([string][4] \| [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
 
-### runOnIOS
+### click
 
-Execute code only on iOS
+Perform a click on a link or a button, given by a locator.
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
 
 ```js
-I.runOnIOS(() => {
-   I.click('//UIAApplication[1]/UIAWindow[1]/UIAButton[1]');
-   I.see('Hi, IOS', '~welcome');
-});
+// simple link
+I.click('Logout');
+// button of form
+I.click('Submit');
+// CSS button
+I.click('#form input[type=submit]');
+// XPath
+I.click('//form/*[@type=submit]');
+// link in context
+I.click('Logout', '#nav');
+// using strict locator
+I.click({css: 'nav a.login'});
 ```
 
-Additional filter can be applied by checking for capabilities.
-For instance, this code will be executed only on iPhone 5s:
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. (optional, default `null`)
+
+### dontSeeCheckboxIsChecked
+
+Verifies that the specified checkbox is not checked.
 
 ```js
-I.runOnIOS({deviceName: 'iPhone 5s'},() => {
-   // ...
-});
+I.dontSeeCheckboxIsChecked('#agree'); // located by ID
+I.dontSeeCheckboxIsChecked('I agree to terms'); // located by label
+I.dontSeeCheckboxIsChecked('agree'); // located by name
 ```
 
-Also capabilities can be checked by a function.
+#### Parameters
+
+-   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+
+### dontSeeElement
+
+Opposite to `seeElement`. Checks that element is not visible (or in DOM)
 
 ```js
-I.runOnAndroid((caps) => {
-   // caps is current config of desiredCapabiliites
-   return caps.platformVersion >= 6
-},() => {
-   // ...
-});
+I.dontSeeElement('.modal'); // modal is not shown
 ```
 
 #### Parameters
 
--   `caps` any 
--   `fn` any 
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|Strict locator.
+
+### dontSeeInField
+
+Checks that value of input field or textarea 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` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][4]** value to check.
+
+### dontSee
+
+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', '.nav'); // no login inside .nav element
+```
+
+#### Parameters
+
+-   `text` **[string][4]** which is not present.
+-   `context` **([string][4] \| [object][6])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. (optional, default `null`)
+
+### fillField
+
+Fills a text field or textarea, after clearing its value, with the given string.
+Field is located by name, label, CSS, or XPath.
+
+```js
+// by label
+I.fillField('Email', 'hello@world.com');
+// by name
+I.fillField('password', secret('123456'));
+// by CSS
+I.fillField('form#login input[name=username]', 'John');
+// or by strict locator
+I.fillField({css: 'form#login input[name=username]'}, 'John');
+```
+
+#### Parameters
+
+-   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][4]** text value to fill.
+
+### 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.
+
+```js
+let pin = await I.grabTextFrom('#pin');
+```
+
+If multiple elements found returns an array of texts.
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+
+Returns **[Promise][13]&lt;([string][4] \| [Array][14]&lt;[string][4]>)>** attribute value
+
+### 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.
+
+```js
+let email = await I.grabValueFrom('input[name=email]');
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** field located by label|name|CSS|XPath|strict locator.
+
+Returns **[Promise][13]&lt;[string][4]>** attribute value
+
+### scrollIntoView
+
+Scroll element into viewport.
+
+```js
+I.scrollIntoView('#submit');
+I.scrollIntoView('#submit', true);
+I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "center" });
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+-   `scrollIntoViewOptions`  
+-   `alignToTop` **([boolean][15] \| [object][6])** (optional) or scrollIntoViewOptions (optional), see [https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView][16].Supported only for web testing
+
+### seeCheckboxIsChecked
+
+Verifies that the specified checkbox is checked.
+
+```js
+I.seeCheckboxIsChecked('Agree');
+I.seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
+I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
+```
+
+#### Parameters
+
+-   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+
+### seeElement
+
+Checks that a given Element is visible
+Element is located by CSS or XPath.
+
+```js
+I.seeElement('#modal');
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+
+### seeInField
+
+Checks that the given input field or textarea equals to given value.
+For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
+
+```js
+I.seeInField('Username', 'davert');
+I.seeInField({css: 'form textarea'},'Type your comment here');
+I.seeInField('form input[type=hidden]','hidden_value');
+I.seeInField('#searchform input','Search');
+```
+
+#### Parameters
+
+-   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][4]** value to check.
 
 ### see
 
@@ -609,531 +1018,657 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
--   `text` [string][4] expected on page.
--   `context` ([string][4] \| [object][5]) (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
-    
+-   `text` **[string][4]** expected on page.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. (optional, default `null`)
+
+### selectOption
+
+Selects an option in a drop-down select.
+Field is searched by label | name | CSS | XPath.
+Option is selected by visible text or by value.
+
+```js
+I.selectOption('Choose Plan', 'Monthly'); // select by label
+I.selectOption('subscription', 'Monthly'); // match option by text
+I.selectOption('subscription', '0'); // or by value
+I.selectOption('//form/select[@name=account]','Premium');
+I.selectOption('form select[name=account]', 'Premium');
+I.selectOption({css: 'form select[name=account]'}, 'Premium');
+```
+
+Provide an array for the second argument to select multiple options.
+
+```js
+I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+```
+
+#### Parameters
+
+-   `select` **([string][4] \| [object][6])** field located by label|name|CSS|XPath|strict locator.
+-   `option` **([string][4] \| [Array][14]&lt;any>)** visible text or value of option.Supported only for web testing
+
+### waitForElement
+
+Waits for element to be present on page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForElement('.btn.continue');
+I.waitForElement('.btn.continue', 5); // wait for 5 secs
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait (optional, default `null`)
+
+### waitForVisible
+
+Waits for an element to become visible on a page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForVisible('#popup');
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
+
+### 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.
+
+```js
+I.waitForInvisible('#popup');
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
+
+### waitForText
+
+Waits for a text to appear (by default waits for 1sec).
+Element can be located by CSS or XPath.
+Narrow down search results by providing context.
+
+```js
+I.waitForText('Thank you, form has been submitted');
+I.waitForText('Thank you, form has been submitted', 5, '#modal');
+```
+
+#### Parameters
+
+-   `text` **[string][4]** to wait for.
+-   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
+-   `context` **([string][4] \| [object][6])?** (optional) element located by CSS|XPath|strict locator. (optional, default `null`)
+
+### \_locate
+
+Get elements by different locator types, including strict locator.
+Should be used in custom helpers:
+
+```js
+this.helpers['WebDriver']._locate({name: 'password'}).then //...
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `smartWait`   (optional, default `false`)
+
+### \_locateCheckable
+
+Find a checkbox by providing human readable text:
+
+```js
+this.helpers['WebDriver']._locateCheckable('I agree with terms and conditions').then // ...
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+
+### \_locateClickable
+
+Find a clickable element by providing human readable text:
+
+```js
+this.helpers['WebDriver']._locateClickable('Next page').then // ...
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+
+### \_locateFields
+
+Find field elements by providing human readable text:
+
+```js
+this.helpers['WebDriver']._locateFields('Your email').then // ...
+```
+
+#### Parameters
+
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
 
+### defineTimeout
 
-### seeAppIsInstalled
+Set [WebDriver timeouts][17] in realtime.
 
-Check if an app is installed.
+Timeouts are expected to be passed as object:
 
 ```js
-I.seeAppIsInstalled("com.example.android.apis");
+I.defineTimeout({ script: 5000 });
+I.defineTimeout({ implicit: 10000, pageLoad: 10000, script: 5000 });
 ```
 
 #### Parameters
 
--   `bundleId`  String  ID of bundled appAppium: support only Android
+-   `timeouts` **WebdriverIO.Timeouts** WebDriver timeouts object.
 
-### seeAppIsNotInstalled
+### amOnPage
 
-Check if an app is not installed.
+Opens a web page in a browser. Requires relative or absolute url.
+If url starts with `/`, opens a web page of a site defined in `url` config parameter.
 
 ```js
-I.seeAppIsNotInstalled("com.example.android.apis");
+I.amOnPage('/'); // opens main page of website
+I.amOnPage('https://github.com'); // opens github
+I.amOnPage('/login'); // opens a login page
 ```
 
 #### Parameters
 
--   `bundleId`  String  ID of bundled appAppium: support only Android
+-   `url` **[string][4]** url path or global url.
 
-### seeCheckboxIsChecked
+### doubleClick
 
-Verifies that the specified checkbox is checked.
+Performs a double-click on an element matched by link|button|label|CSS or XPath.
+Context can be specified as second parameter to narrow search.
 
 ```js
-I.seeCheckboxIsChecked('Agree');
-I.seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
-I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
+I.doubleClick('Edit');
+I.doubleClick('Edit', '.actions');
+I.doubleClick({css: 'button.accept'});
+I.doubleClick('.btn.edit');
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator.
-    
-
+-   `locator` **([string][4] \| [object][6])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.{{ react }} (optional, default `null`)
 
-### seeCurrentActivityIs
+### rightClick
 
-Check current activity on an Android device.
+Performs right click on a clickable element matched by semantic locator, CSS or XPath.
 
 ```js
-I.seeCurrentActivityIs(".HomeScreenActivity")
+// right click element with id el
+I.rightClick('#el');
+// right click link or button with text "Click me"
+I.rightClick('Click me');
+// right click button with text "Click me" inside .context
+I.rightClick('Click me', '.context');
 ```
 
-Appium: support only Android
-
 #### Parameters
 
--   `currentActivity`  
+-   `locator` **([string][4] \| [object][6])** clickable element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator.{{ react }} (optional, default `null`)
 
-### seeDeviceIsLocked
+### clearField
 
-Check whether the device is locked.
+Clears a `<textarea>` or text `<input>` element's value.
 
 ```js
-I.seeDeviceIsLocked();
+I.clearField('Email');
+I.clearField('user[email]');
+I.clearField('#email');
 ```
 
-Appium: support only Android
+#### Parameters
 
-### seeDeviceIsUnlocked
+-   `field`  
+-   `editable` **([string][4] \| [object][6])** field located by label|name|CSS|XPath|strict locator.
 
-Check whether the device is not locked.
+### attachFile
+
+Attaches a file to element located by label, name, CSS or XPath
+Path to file is relative current codecept directory (where codecept.json or codecept.conf.js is located).
+File will be uploaded to remote system (if tests are running remotely).
 
 ```js
-I.seeDeviceIsUnlocked();
+I.attachFile('Avatar', 'data/avatar.jpg');
+I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 ```
 
-Appium: support only Android
+#### Parameters
 
-### seeElement
+-   `locator` **([string][4] \| [object][6])** field located by label|name|CSS|XPath|strict locator.
+-   `pathToFile` **[string][4]** local file path relative to codecept.json config file.
+    Appium: not tested
 
-Checks that a given Element is visible
-Element is located by CSS or XPath.
+### uncheckOption
+
+Unselects a checkbox or radio button.
+Element is located by label or name or CSS or XPath.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
 
 ```js
-I.seeElement('#modal');
+I.uncheckOption('#agree');
+I.uncheckOption('I Agree to Terms and Conditions');
+I.uncheckOption('agree', '//form');
 ```
 
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) located by CSS|XPath|strict locator.
-    
+-   `field` **([string][4] \| [object][6])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][4]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator.
+    Appium: not tested (optional, default `null`)
 
+### grabHTMLFrom
 
-### seeInField
-
-Checks that the given input field or textarea equals to given value.
-For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
+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.
+If more than one element is found - an array of HTMLs returned.
 
 ```js
-I.seeInField('Username', 'davert');
-I.seeInField({css: 'form textarea'},'Type your comment here');
-I.seeInField('form input[type=hidden]','hidden_value');
-I.seeInField('#searchform input','Search');
+let postHTML = await I.grabHTMLFrom('#post');
 ```
 
 #### Parameters
 
--   `field` ([string][4] \| [object][5]) located by label|name|CSS|XPath|strict locator.
--   `value` [string][4] value to check.
-    
+-   `locator`  
+-   `element` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
 
+Returns **[Promise][13]&lt;[string][4]>** HTML code for an element
 
-### seeOrientationIs
+### grabAttributeFrom
 
-Check the device orientation
+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.
 
 ```js
-I.seeOrientationIs('PORTRAIT');
-I.seeOrientationIs('LANDSCAPE')
+let hint = await I.grabAttributeFrom('#tooltip', 'title');
 ```
 
 #### Parameters
 
--   `orientation`  LANDSCAPE or PORTRAITAppium: support Android and iOS
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][4]** attribute name.
 
-### selectOption
+Returns **[Promise][13]&lt;[string][4]>** attribute value
+Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
 
-Selects an option in a drop-down select.
-Field is searched by label | name | CSS | XPath.
-Option is selected by visible text or by value.
+### seeTextEquals
+
+Checks that text is equal to provided one.
 
 ```js
-I.selectOption('Choose Plan', 'Monthly'); // select by label
-I.selectOption('subscription', 'Monthly'); // match option by text
-I.selectOption('subscription', '0'); // or by value
-I.selectOption('//form/select[@name=account]','Premium');
-I.selectOption('form select[name=account]', 'Premium');
-I.selectOption({css: 'form select[name=account]'}, 'Premium');
+I.seeTextEquals('text', 'h1');
 ```
 
-Provide an array for the second argument to select multiple options.
+#### Parameters
+
+-   `text` **[string][4]** element value to check.
+-   `context` **([string][4] \| [object][6]?)** element located by CSS|XPath|strict locator. (optional, default `null`)
+
+### seeElementInDOM
+
+Checks that a given Element is present in the DOM
+Element is located by CSS or XPath.
 
 ```js
-I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+I.seeElementInDOM('#modal');
 ```
 
 #### Parameters
 
--   `select` ([string][4] \| [object][5]) field located by label|name|CSS|XPath|strict locator.
--   `option` ([string][4] \| [array][9]) visible text or value of option.
-    
--   Supported on only for web testing!
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
 
-### sendDeviceKeyEvent
+### dontSeeElementInDOM
 
-Send a key event to the device.
-List of keys: [https://developer.android.com/reference/android/view/KeyEvent.html][10]
+Opposite to `seeElementInDOM`. Checks that element is not on page.
 
 ```js
-I.sendDeviceKeyEvent(3);
+I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
 ```
 
 #### Parameters
 
--   `keyValue`  Device specific key valueAppium: support only Android
-
-### setImmediateValue
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|Strict locator.
 
-Set immediate value in app.
+### seeInSource
 
-See corresponding [webdriverio reference][11].
+Checks that the current page contains the given string in its raw source code.
 
-Appium: support only iOS
+```js
+I.seeInSource('<h1>Green eggs &amp; ham</h1>');
+```
 
 #### Parameters
 
--   `id`  
--   `value`  
-
-### setNetworkConnection
+-   `text` **[string][4]** value to check.
 
-Set network connection mode.
+### grabSource
 
--   airplane mode
--   wifi mode
--   data data
+Retrieves page source and returns it to test.
+Resumes test execution, so should be used inside an async function.
 
 ```js
-I.setNetworkConnection(0) // airplane mode off, wifi off, data off
-I.setNetworkConnection(1) // airplane mode on, wifi off, data off
-I.setNetworkConnection(2) // airplane mode off, wifi on, data off
-I.setNetworkConnection(4) // airplane mode off, wifi off, data on
-I.setNetworkConnection(6) // airplane mode off, wifi on, data on
+let pageSource = await I.grabSource();
 ```
 
-See corresponding [webdriverio reference][12].
+Returns **[Promise][13]&lt;[string][4]>** source code
 
-Appium: support only Android
+### grabBrowserLogs
 
-#### Parameters
+Get JS log from browser. Log buffer is reset after each request.
 
--   `value`  
+```js
+let logs = await I.grabBrowserLogs();
+console.log(JSON.stringify(logs))
+```
 
-### setOrientation
+Returns **[Promise][13]&lt;([string][4] \| [undefined][18])>** 
 
-Set a device orientation. Will fail, if app will not set orientation
+### dontSeeInSource
+
+Checks that the current page does not contains the given string in its raw source code.
 
 ```js
-I.setOrientation('PORTRAIT');
-I.setOrientation('LANDSCAPE')
+I.dontSeeInSource('<!--'); // no comments in source
 ```
 
 #### Parameters
 
--   `orientation`  LANDSCAPE or PORTRAITAppium: support Android and iOS
+-   `text`  
+-   `value` **[string][4]** to check.
 
-### setSettings
+### seeNumberOfElements
 
-Update the current setting on the device
+Asserts that an element appears a given number of times in the DOM.
+Element is located by label or name or CSS or XPath.
 
 ```js
-I.setSettings({cyberdelia: 'open'});
+I.seeNumberOfElements('#submitBtn', 1);
 ```
 
 #### Parameters
 
--   `settings`  objectAppium: support Android and iOS
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `num` **[number][8]** number of elements.{{ react }}
 
-### shakeDevice
+### seeNumberOfVisibleElements
 
-Perform a shake action on the device.
+Asserts that an element is visible a given number of times.
+Element is located by CSS or XPath.
 
 ```js
-I.shakeDevice();
+I.seeNumberOfVisibleElements('.buttons', 3);
 ```
 
-Appium: support only iOS
+#### Parameters
 
-### simulateTouchId
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `num` **[number][8]** number of elements.{{ react }}
 
-Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
+### seeAttributesOnElements
+
+Checks that all elements with given locator have given attributes.
 
 ```js
-I.touchId(); // simulates valid fingerprint
-I.touchId(true); // simulates valid fingerprint
-I.touchId(false); // simulates invalid fingerprint
+I.seeAttributesOnElements('//form', { method: "post"});
 ```
 
-Appium: support only iOS
-TODO: not tested
-
 #### Parameters
 
--   `match`  
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+-   `attributes` **[object][6]** attributes and their values to check.
 
-### startActivity
+### grabNumberOfVisibleElements
 
-Start an arbitrary Android activity during a session.
+Grab number of visible elements by locator.
 
 ```js
-I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
+let numOfElements = await I.grabNumberOfVisibleElements('p');
 ```
 
-Appium: support only Android
-
 #### Parameters
 
--   `appPackage`  
--   `appActivity`  
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
 
-### swipe
+Returns **[Promise][13]&lt;[number][8]>** number of visible elements
 
-Perform a swipe on the screen or an element.
+### scrollTo
+
+Scrolls to element matched by locator.
+Extra shift can be set with offsetX and offsetY options.
 
 ```js
-let locator = "#io.selendroid.testapp:id/LinearLayout1";
-I.swipe(locator, 800, 1200, 1000);
+I.scrollTo('footer');
+I.scrollTo('#submit', 5, 5);
 ```
 
-[See complete reference][13]
-
 #### Parameters
 
--   `locator`  
--   `xoffset`  
--   `yoffset`  
--   `speed`  (optional), 1000 by defaultAppium: support Android and iOS
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+-   `offsetX` **[number][8]** (optional, `0` by default) X-axis offset. (optional, default `0`)
+-   `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset. (optional, default `0`)
 
-### swipeDown
+### moveCursorTo
 
-Perform a swipe down on an element.
+Moves cursor to element matched by locator.
+Extra shift can be set with offsetX and offsetY options.
 
 ```js
-let locator = "#io.selendroid.testapp:id/LinearLayout1";
-I.swipeDown(locator); // simple swipe
-I.swipeDown(locator, 500); // set speed
-I.swipeDown(locator, 1200, 1000); // set offset and speed
+I.moveCursorTo('.tooltip');
+I.moveCursorTo('#submit', 5,5);
 ```
 
 #### Parameters
 
--   `locator`  
--   `yoffset`  (optional)
--   `speed`  (optional), 1000 by defaultAppium: support Android and iOS
+-   `locator` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+-   `offsetX` **[number][8]** (optional, `0` by default) X-axis offset. (optional, default `0`)
+-   `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset. (optional, default `0`)
 
-### swipeLeft
+### saveScreenshot
 
-Perform a swipe left on an element.
+Saves a screenshot to ouput folder (set in codecept.json or codecept.conf.js).
+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
-let locator = "#io.selendroid.testapp:id/LinearLayout1";
-I.swipeLeft(locator); // simple swipe
-I.swipeLeft(locator, 500); // set speed
-I.swipeLeft(locator, 1200, 1000); // set offset and speed
+I.saveScreenshot('debug.png');
+I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scrollWidth before taking screenshot
 ```
 
 #### Parameters
 
--   `locator`  
--   `xoffset`  (optional)
--   `speed`  (optional), 1000 by defaultAppium: support Android and iOS
+-   `fileName` **[string][4]** file name to save.
+-   `fullPage` **[boolean][15]** (optional, `false` by default) flag to enable fullscreen screenshot mode. (optional, default `false`)
 
-### swipeRight
+### dragAndDrop
 
-Perform a swipe right on an element.
+Drag an item to a destination element.
 
 ```js
-let locator = "#io.selendroid.testapp:id/LinearLayout1";
-I.swipeRight(locator); // simple swipe
-I.swipeRight(locator, 500); // set speed
-I.swipeRight(locator, 1200, 1000); // set offset and speed
+I.dragAndDrop('#dragHandle', '#container');
 ```
 
 #### Parameters
 
--   `locator`  
--   `xoffset`  (optional)
--   `speed`  (optional), 1000 by defaultAppium: support Android and iOS
+-   `srcElement` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+-   `destElement` **([string][4] \| [object][6])** located by CSS|XPath|strict locator.
+    Appium: not tested
 
-### swipeTo
+### dragSlider
 
-Perform a swipe in selected direction on an element to searchable element.
+Drag the scrubber of a slider to a given position
+For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
 
 ```js
-I.swipeTo(
- "android.widget.CheckBox", // searchable element
- "//android.widget.ScrollView/android.widget.LinearLayout", // scroll element
-  "up", // direction
-   30,
-   100,
-   500);
+I.dragSlider('#slider', 30);
+I.dragSlider('#slider', -70);
 ```
 
 #### Parameters
 
--   `searchableLocator`  
--   `scrollLocator`  
--   `direction`  
--   `timeout`  
--   `offset`  
--   `speed`  Appium: support Android and iOS
+-   `locator` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
+-   `offsetX` **[number][8]** position to drag. (optional, default `0`)
 
-### swipeUp
+### grabAllWindowHandles
 
-Perform a swipe up on an element.
+Get all Window Handles.
+Useful for referencing a specific handle when calling `I.switchToWindow(handle)`
 
 ```js
-let locator = "#io.selendroid.testapp:id/LinearLayout1";
-I.swipeUp(locator); // simple swipe
-I.swipeUp(locator, 500); // set speed
-I.swipeUp(locator, 1200, 1000); // set offset and speed
+const windows = await I.grabAllWindowHandles();
 ```
 
-#### Parameters
+### grabCurrentWindowHandle
 
--   `locator`  
--   `yoffset`  (optional)
--   `speed`  (optional), 1000 by defaultAppium: support Android and iOS
+Get the current Window Handle.
+Useful for referencing it when calling `I.switchToWindow(handle)`
 
-### switchToNative
+```js
+const window = await I.grabCurrentWindowHandle();
+```
 
-Switches to native context.
-By default switches to NATIVE_APP context unless other specified.
+### switchToWindow
+
+Switch to the window with a specified handle.
 
 ```js
-I.switchToNative();
+const windows = await I.grabAllWindowHandles();
+// ... do something
+await I.switchToWindow( windows[0] );
 
-// or set context explicitly
-I.switchToNative('SOME_OTHER_CONTEXT');
+const window = await I.grabCurrentWindowHandle();
+// ... do something
+await I.switchToWindow( window );
 ```
 
 #### Parameters
 
--   `context` any  
+-   `window`  
 
-### switchToWeb
+### closeOtherTabs
 
-Switches to web context.
-If no context is provided switches to the first detected web context
+Close all tabs except for the current one.
 
 ```js
-// switch to first web context
-I.switchToWeb();
+I.closeOtherTabs();
+```
 
-// or set the context explicitly
-I.switchToWeb('WEBVIEW_io.selendroid.testapp');
+### 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
 
--   `context` [string][4]? 
+-   `locator` **([string][4]? | [object][6])** (optional, `null` by default) element located by CSS|XPath|strict locator. (optional, default `null`)
 
-### tap
+### grabNumberOfOpenTabs
 
-Taps on element.
+Grab number of open tabs.
 
 ```js
-I.tap("~buttonStartWebviewCD");
+let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Shortcut for `makeTouchAction`
-
-#### Parameters
-
--   `locator` any 
+Returns **[Promise][13]&lt;[number][8]>** number of open tabs
 
-### touchPerform
+### scrollPageToTop
 
-Performs a specific touch action.
-The action object need to contain the action name, x/y coordinates
+Scroll page to the top.
 
 ```js
-I.touchPerform([{
-    action: 'press',
-    options: {
-      x: 100,
-      y: 200
-    }
-}, {action: 'release'}])
-
-I.touchPerform([{
-   action: 'tap',
-   options: {
-       element: '1', // json web element was queried before
-       x: 10,   // x offset
-       y: 20,   // y offset
-       count: 1 // number of touches
-   }
-}]);
+I.scrollPageToTop();
 ```
 
-Appium: support Android and iOS
+### scrollPageToBottom
 
-#### Parameters
+Scroll page to the bottom.
 
--   `actions`  
+```js
+I.scrollPageToBottom();
+```
 
-### waitForElement
+### grabPageScrollPosition
 
-Waits for element to be present on page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+Retrieves a page scroll position and returns it to test.
+Resumes test execution, so **should be used inside an async function with `await`** operator.
 
 ```js
-I.waitForElement('.btn.continue');
-I.waitForElement('.btn.continue', 5); // wait for 5 secs
+let { x, y } = await I.grabPageScrollPosition();
 ```
 
-#### Parameters
-
--   `locator` ([string][4] \| [object][5]) element located by CSS|XPath|strict locator.
--   `sec` [number][14] (optional, `1` by default) time in seconds to wait
-    
- 
+Returns **[Promise][13]&lt;[Object][6]&lt;[string][4], any>>** scroll position
 
-### waitForInvisible
+### setGeoLocation
 
-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.
+Set the current geo location
 
 ```js
-I.waitForInvisible('#popup');
+I.setGeoLocation(121.21, 11.56);
+I.setGeoLocation(121.21, 11.56, 10);
 ```
 
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) element located by CSS|XPath|strict locator.
--   `sec` [number][14] (optional, `1` by default) time in seconds to wait
-    
- 
+-   `latitude` **[number][8]** to set.
+-   `longitude` **[number][8]** to set
+-   `altitude` **[number][8]** (optional, null by default) to set (optional, default `null`)
 
-### waitForText
+### grabGeoLocation
 
-Waits for a text to appear (by default waits for 1sec).
-Element can be located by CSS or XPath.
-Narrow down search results by providing context.
+Return the current geo location 
 
 ```js
-I.waitForText('Thank you, form has been submitted');
-I.waitForText('Thank you, form has been submitted', 5, '#modal');
+let geoLocation = await I.grabGeoLocation();
 ```
 
-#### Parameters
+### grabElementBoundingRect
 
--   `text` [string][4] to wait for.
--   `sec` [number][14] (optional, `1` by default) time in seconds to wait 
--   `context` ([string][4] \| [object][5]) (optional) element located by CSS|XPath|strict locator.
-    
- 
+Grab the width, height, location of given locator.
+Provide `width` or `height`as second param to get your desired prop.
+Resumes test execution, so **should be used inside an async function with `await`** operator.
 
-### waitForVisible
+Returns an object with `x`, `y`, `width`, `height` keys.
 
-Waits for an element to become visible on a page (by default waits for 1sec).
-Element can be located by CSS or XPath.
+```js
+const value = await I.grabElementBoundingRect('h3');
+// value is like { x: 226.5, y: 89, width: 527, height: 220 }
+```
+
+To get only one metric use second parameter:
 
 ```js
-I.waitForVisible('#popup');
+const width = await I.grabElementBoundingRect('h3', 'width');
+// width == 527
 ```
 
 #### Parameters
 
--   `locator` ([string][4] \| [object][5]) element located by CSS|XPath|strict locator.
--   `sec` [number][14] (optional, `1` by default) time in seconds to wait
-    
- 
+-   `locator` **([string][4] \| [object][6])** element located by CSS|XPath|strict locator.
+-   `prop`  
+-   `elementSize` **[string][4]** x, y, width or height of the given element.
+
+Returns **[object][6]** Element bounding rectangle
 
 [1]: http://codecept.io/helpers/WebDriver/
 
@@ -1143,22 +1678,30 @@ I.waitForVisible('#popup');
 
 [4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[5]: http://webdriver.io/api/mobile/setNetworkConnection.html
+
+[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+
+[7]: https://developer.android.com/reference/android/view/KeyEvent.html
+
+[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+
+[9]: http://webdriver.io/api/mobile/touchAction.html
 
-[6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[10]: http://webdriver.io/api/mobile/swipe.html
 
-[7]: http://webdriver.io/api/mobile/touchAction.html
+[11]: http://webdriver.io/api/mobile/rotate.html
 
-[8]: http://webdriver.io/api/mobile/rotate.html
+[12]: http://webdriver.io/api/mobile/setImmediateValue.html
 
-[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[13]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[10]: https://developer.android.com/reference/android/view/KeyEvent.html
+[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[11]: http://webdriver.io/api/mobile/setImmediateValue.html
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[12]: http://webdriver.io/api/mobile/setNetworkConnection.html
+[16]: https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView
 
-[13]: http://webdriver.io/api/mobile/swipe.html
+[17]: https://webdriver.io/docs/timeouts.html
 
-[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined