codeceptjs 3.3.1 → 3.3.4

package/docs/helpers/Appium.md

@@ -150,8 +150,6 @@ I.runOnAndroid((caps) => {
 -   `caps` **any** 
 -   `fn` **any** 
 
-Returns **[Promise][4]<any>** 
-
 ### runOnAndroid
 
 Execute code only on Android
@@ -188,8 +186,6 @@ I.runOnAndroid((caps) => {
 -   `caps` **any** 
 -   `fn` **any** 
 
-Returns **[Promise][4]<any>** 
-
 ### runInWeb
 
 Execute code only in Web mode.
@@ -205,8 +201,6 @@ I.runInWeb(() => {
 
 -   `fn` **any** 
 
-Returns **[Promise][4]<any>** 
-
 ### seeAppIsInstalled
 
 Check if an app is installed.
@@ -217,9 +211,9 @@ I.seeAppIsInstalled("com.example.android.apis");
 
 #### Parameters
 
--   `bundleId` **[string][5]** String  ID of bundled app
+-   `bundleId` **[string][4]** String  ID of bundled app
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### seeAppIsNotInstalled
 
@@ -231,9 +225,9 @@ I.seeAppIsNotInstalled("com.example.android.apis");
 
 #### Parameters
 
--   `bundleId` **[string][5]** String  ID of bundled app
+-   `bundleId` **[string][4]** String  ID of bundled app
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### installApp
 
@@ -245,9 +239,9 @@ I.installApp('/path/to/file.apk');
 
 #### Parameters
 
--   `path` **[string][5]** path to apk file
+-   `path` **[string][4]** path to apk file
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### removeApp
 
@@ -261,10 +255,8 @@ Appium: support only Android
 
 #### Parameters
 
--   `appId` **[string][5]** 
--   `bundleId` **[string][5]?** ID of bundle
-
-Returns **[Promise][4]<any>** 
+-   `appId` **[string][4]** 
+-   `bundleId` **[string][4]?** ID of bundle
 
 ### seeCurrentActivityIs
 
@@ -276,9 +268,9 @@ I.seeCurrentActivityIs(".HomeScreenActivity")
 
 #### Parameters
 
--   `currentActivity` **[string][5]** 
+-   `currentActivity` **[string][4]** 
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### seeDeviceIsLocked
 
@@ -288,7 +280,7 @@ Check whether the device is locked.
 I.seeDeviceIsLocked();
 ```
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### seeDeviceIsUnlocked
 
@@ -298,7 +290,7 @@ Check whether the device is not locked.
 I.seeDeviceIsUnlocked();
 ```
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### seeOrientationIs
 
@@ -313,7 +305,7 @@ I.seeOrientationIs('LANDSCAPE')
 
 -   `orientation` **(`"LANDSCAPE"` \| `"PORTRAIT"`)** LANDSCAPE or PORTRAITAppium: support Android and iOS
 
-Returns **[Promise][4]<void>** 
+Returns **[Promise][5]<void>** 
 
 ### setOrientation
 
@@ -326,9 +318,7 @@ I.setOrientation('LANDSCAPE')
 
 #### Parameters
 
--   `orientation` **(`"LANDSCAPE"` \| `"PORTRAIT"`)** LANDSCAPE or PORTRAIT
-
-Returns **[Promise][4]<any>** Appium: support Android and iOS
+-   `orientation` **(`"LANDSCAPE"` \| `"PORTRAIT"`)** LANDSCAPE or PORTRAITAppium: support Android and iOS
 
 ### grabAllContexts
 
@@ -336,7 +326,7 @@ Get list of all available contexts
 
     let contexts = await I.grabAllContexts();
 
-Returns **[Promise][4]<[Array][6]<[string][5]>>** Appium: support Android and iOS
+Returns **[Promise][5]<[Array][6]<[string][4]>>** Appium: support Android and iOS
 
 ### grabContext
 
@@ -346,7 +336,7 @@ Retrieve current context
 let context = await I.grabContext();
 ```
 
-Returns **[Promise][4]<([string][5] | null)>** Appium: support Android and iOS
+Returns **[Promise][5]<([string][4] | null)>** Appium: support Android and iOS
 
 ### grabCurrentActivity
 
@@ -356,7 +346,7 @@ Get current device activity.
 let activity = await I.grabCurrentActivity();
 ```
 
-Returns **[Promise][4]<[string][5]>** Appium: support only Android
+Returns **[Promise][5]<[string][4]>** Appium: support only Android
 
 ### grabNetworkConnection
 
@@ -368,7 +358,7 @@ properties to the response object to allow easier assertions.
 let con = await I.grabNetworkConnection();
 ```
 
-Returns **[Promise][4]<{}>** Appium: support only Android
+Returns **[Promise][5]<{}>** Appium: support only Android
 
 ### grabOrientation
 
@@ -378,7 +368,7 @@ Get current orientation.
 let orientation = await I.grabOrientation();
 ```
 
-Returns **[Promise][4]<[string][5]>** Appium: support Android and iOS
+Returns **[Promise][5]<[string][4]>** Appium: support Android and iOS
 
 ### grabSettings
 
@@ -388,7 +378,7 @@ Get all the currently specified settings.
 let settings = await I.grabSettings();
 ```
 
-Returns **[Promise][4]<[string][5]>** Appium: support Android and iOS
+Returns **[Promise][5]<[string][4]>** Appium: support Android and iOS
 
 ### \_switchToContext
 
@@ -398,8 +388,6 @@ Switch to the specified context.
 
 -   `context` **any** the context to switch to
 
-Returns **[Promise][4]<any>** 
-
 ### switchToWeb
 
 Switches to web context.
@@ -415,9 +403,9 @@ I.switchToWeb('WEBVIEW_io.selendroid.testapp');
 
 #### Parameters
 
--   `context` **[string][5]?** 
+-   `context` **[string][4]?** 
 
-Returns **[Promise][4]<void>** 
+Returns **[Promise][5]<void>** 
 
 ### switchToNative
 
@@ -435,7 +423,7 @@ I.switchToNative('SOME_OTHER_CONTEXT');
 
 -   `context` **any?**  (optional, default `null`)
 
-Returns **[Promise][4]<void>** 
+Returns **[Promise][5]<void>** 
 
 ### startActivity
 
@@ -450,7 +438,7 @@ I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
 -   `appPackage`  
 -   `appActivity`  
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### setNetworkConnection
 
@@ -474,7 +462,7 @@ See corresponding [webdriverio reference][7].
 
 -   `value`  
 
-Returns **[Promise][4]<{}>** Appium: support only Android
+Returns **[Promise][5]<{}>** Appium: support only Android
 
 ### setSettings
 
@@ -486,9 +474,7 @@ I.setSettings({cyberdelia: 'open'});
 
 #### Parameters
 
--   `settings` **[object][8]** object
-
-Returns **[Promise][4]<any>** Appium: support Android and iOS
+-   `settings` **[object][8]** objectAppium: support Android and iOS
 
 ### hideDeviceKeyboard
 
@@ -508,9 +494,7 @@ Appium: support Android and iOS
 #### Parameters
 
 -   `strategy` **(`"tapOutside"` \| `"pressKey"`)?** Desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)
--   `key` **[string][5]?** Optional key
-
-Returns **[Promise][4]<any>** 
+-   `key` **[string][4]?** Optional key
 
 ### sendDeviceKeyEvent
 
@@ -525,7 +509,7 @@ I.sendDeviceKeyEvent(3);
 
 -   `keyValue` **[number][10]** Device specific key value
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### openNotifications
 
@@ -535,7 +519,7 @@ Open the notifications panel on the device.
 I.openNotifications();
 ```
 
-Returns **[Promise][4]<void>** Appium: support only Android
+Returns **[Promise][5]<void>** Appium: support only Android
 
 ### makeTouchAction
 
@@ -554,7 +538,7 @@ I.makeTouchAction("~buttonStartWebviewCD", 'tap');
 -   `locator`  
 -   `action`  
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### tap
 
@@ -570,7 +554,7 @@ Shortcut for `makeTouchAction`
 
 -   `locator` **any** 
 
-Returns **[Promise][4]<void>** 
+Returns **[Promise][5]<void>** 
 
 ### swipe
 
@@ -585,12 +569,12 @@ I.swipe(locator, 800, 1200, 1000);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** 
+-   `locator` **([string][4] \| [object][8])** 
 -   `xoffset` **[number][10]** 
 -   `yoffset` **[number][10]** 
 -   `speed` **[number][10]** (optional), 1000 by default (optional, default `1000`)
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### performSwipe
 
@@ -603,9 +587,7 @@ I.performSwipe({ x: 300, y: 100 }, { x: 200, y: 100 });
 #### Parameters
 
 -   `from` **[object][8]** 
--   `to` **[object][8]** 
-
-Returns **[Promise][4]<any>** Appium: support Android and iOS
+-   `to` **[object][8]** Appium: support Android and iOS
 
 ### swipeDown
 
@@ -620,11 +602,11 @@ I.swipeDown(locator, 1200, 1000); // set offset and speed
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** 
+-   `locator` **([string][4] \| [object][8])** 
 -   `yoffset` **[number][10]?** (optional) (optional, default `1000`)
 -   `speed` **[number][10]** (optional), 1000 by default (optional, default `1000`)
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### swipeLeft
 
@@ -639,11 +621,11 @@ I.swipeLeft(locator, 1200, 1000); // set offset and speed
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** 
+-   `locator` **([string][4] \| [object][8])** 
 -   `xoffset` **[number][10]?** (optional) (optional, default `1000`)
 -   `speed` **[number][10]** (optional), 1000 by default (optional, default `1000`)
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### swipeRight
 
@@ -658,11 +640,11 @@ I.swipeRight(locator, 1200, 1000); // set offset and speed
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** 
+-   `locator` **([string][4] \| [object][8])** 
 -   `xoffset` **[number][10]?** (optional) (optional, default `1000`)
 -   `speed` **[number][10]** (optional), 1000 by default (optional, default `1000`)
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### swipeUp
 
@@ -677,11 +659,11 @@ I.swipeUp(locator, 1200, 1000); // set offset and speed
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** 
+-   `locator` **([string][4] \| [object][8])** 
 -   `yoffset` **[number][10]?** (optional) (optional, default `1000`)
 -   `speed` **[number][10]** (optional), 1000 by default (optional, default `1000`)
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### swipeTo
 
@@ -699,14 +681,14 @@ I.swipeTo(
 
 #### Parameters
 
--   `searchableLocator` **[string][5]** 
--   `scrollLocator` **[string][5]** 
--   `direction` **[string][5]** 
+-   `searchableLocator` **[string][4]** 
+-   `scrollLocator` **[string][4]** 
+-   `direction` **[string][4]** 
 -   `timeout` **[number][10]** 
 -   `offset` **[number][10]** 
 -   `speed` **[number][10]** 
 
-Returns **[Promise][4]<void>** Appium: support Android and iOS
+Returns **[Promise][5]<void>** Appium: support Android and iOS
 
 ### touchPerform
 
@@ -739,8 +721,6 @@ Appium: support Android and iOS
 
 -   `actions` **[Array][6]** Array of touch actions
 
-Returns **[Promise][4]<any>** 
-
 ### pullFile
 
 Pulls a file from the device.
@@ -753,10 +733,10 @@ I.pullFile('/storage/emulated/0/DCIM/logo.png', output_dir);
 
 #### Parameters
 
--   `path` **[string][5]** 
--   `dest` **[string][5]** 
+-   `path` **[string][4]** 
+-   `dest` **[string][4]** 
 
-Returns **[Promise][4]<[string][5]>** Appium: support Android and iOS
+Returns **[Promise][5]<[string][4]>** Appium: support Android and iOS
 
 ### shakeDevice
 
@@ -766,7 +746,7 @@ Perform a shake action on the device.
 I.shakeDevice();
 ```
 
-Returns **[Promise][4]<void>** Appium: support only iOS
+Returns **[Promise][5]<void>** Appium: support only iOS
 
 ### rotate
 
@@ -787,7 +767,7 @@ See corresponding [webdriverio reference][13].
 -   `rotation`  
 -   `touchCount`  
 
-Returns **[Promise][4]<void>** Appium: support only iOS
+Returns **[Promise][5]<void>** Appium: support only iOS
 
 ### setImmediateValue
 
@@ -800,7 +780,7 @@ See corresponding [webdriverio reference][14].
 -   `id`  
 -   `value`  
 
-Returns **[Promise][4]<void>** Appium: support only iOS
+Returns **[Promise][5]<void>** Appium: support only iOS
 
 ### simulateTouchId
 
@@ -816,7 +796,7 @@ I.touchId(false); // simulates invalid fingerprint
 
 -   `match`  
 
-Returns **[Promise][4]<void>** Appium: support only iOS
+Returns **[Promise][5]<void>** Appium: support only iOS
 TODO: not tested
 
 ### closeApp
@@ -827,7 +807,7 @@ Close the given application.
 I.closeApp();
 ```
 
-Returns **[Promise][4]<void>** Appium: support only iOS
+Returns **[Promise][5]<void>** Appium: support only iOS
 
 ### appendField
 
@@ -840,10 +820,9 @@ I.appendField('#myTextField', 'appended');
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator
--   `value` **[string][5]** text value to append.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator
+-   `value` **[string][4]** text value to append.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### checkOption
 
@@ -860,10 +839,9 @@ I.checkOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### click
 
@@ -891,10 +869,9 @@ I.click({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][5]? | [object][8] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][8] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### dontSeeCheckboxIsChecked
 
@@ -908,9 +885,8 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeElement
 
@@ -922,9 +898,8 @@ I.dontSeeElement('.modal'); // modal is not shown
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|Strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeInField
 
@@ -938,10 +913,9 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][5]** value to check.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][4]** value to check.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### dontSee
 
@@ -955,10 +929,9 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 
 #### Parameters
 
--   `text` **[string][5]** which is not present.
--   `context` **([string][5] \| [object][8])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `text` **[string][4]** which is not present.
+-   `context` **([string][4] \| [object][8])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### fillField
 
@@ -978,10 +951,9 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
--   `value` **([string][5] \| [object][8])** text value to fill.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+-   `value` **([string][4] \| [object][8])** text value to fill.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### grabTextFromAll
 
@@ -994,9 +966,9 @@ let pins = await I.grabTextFromAll('#pin li');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[Array][6]<[string][5]>>** attribute value
+Returns **[Promise][5]<[Array][6]<[string][4]>>** attribute value
 
 ### grabTextFrom
 
@@ -1011,9 +983,9 @@ If multiple elements found returns first element.
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[string][5]>** attribute value
+Returns **[Promise][5]<[string][4]>** attribute value
 
 ### grabNumberOfVisibleElements
 
@@ -1026,9 +998,9 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[number][10]>** number of visible elements
+Returns **[Promise][5]<[number][10]>** number of visible elements
 
 ### grabAttributeFrom
 
@@ -1044,10 +1016,10 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `attr` **[string][5]** attribute name.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][4]** attribute name.
 
-Returns **[Promise][4]<[string][5]>** attribute value
+Returns **[Promise][5]<[string][4]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -1061,10 +1033,10 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `attr` **[string][5]** attribute name.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `attr` **[string][4]** attribute name.
 
-Returns **[Promise][4]<[Array][6]<[string][5]>>** attribute value
+Returns **[Promise][5]<[Array][6]<[string][4]>>** attribute value
 
 ### grabValueFromAll
 
@@ -1077,9 +1049,9 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[Array][6]<[string][5]>>** attribute value
+Returns **[Promise][5]<[Array][6]<[string][4]>>** attribute value
 
 ### grabValueFrom
 
@@ -1093,9 +1065,9 @@ let email = await I.grabValueFrom('input[name=email]');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[string][5]>** attribute value
+Returns **[Promise][5]<[string][4]>** attribute value
 
 ### saveScreenshot
 
@@ -1108,9 +1080,9 @@ I.saveScreenshot('debug.png');
 
 #### Parameters
 
--   `fileName` **[string][5]** file name to save.
+-   `fileName` **[string][4]** file name to save.
 
-Returns **[Promise][4]<void>** 
+Returns **[Promise][5]<void>** 
 
 ### scrollIntoView
 
@@ -1124,10 +1096,9 @@ I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "cent
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 -   `scrollIntoViewOptions` **ScrollIntoViewOptions** see [https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView][15].
-
-Returns **[Promise][4]<any>** Supported only for web testing
+    [!] returns a _promise_ which is synchronized internally by recorderSupported only for web testing
 
 ### seeCheckboxIsChecked
 
@@ -1141,9 +1112,8 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### seeElement
 
@@ -1156,9 +1126,8 @@ I.seeElement('#modal');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### seeInField
 
@@ -1174,10 +1143,9 @@ I.seeInField('#searchform input','Search');
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][5]** value to check.
-
-Returns **[Promise][4]<any>** 
+-   `field` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+-   `value` **[string][4]** value to check.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### see
 
@@ -1192,10 +1160,9 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 
 #### Parameters
 
--   `text` **[string][5]** expected on page.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `text` **[string][4]** expected on page.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### selectOption
 
@@ -1220,10 +1187,9 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 #### Parameters
 
--   `select` **([string][5] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
--   `option` **([string][5] \| [Array][6]<any>)** visible text or value of option.
-
-Returns **[Promise][4]<any>** Supported only for web testing
+-   `select` **([string][4] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
+-   `option` **([string][4] \| [Array][6]<any>)** visible text or value of option.
+    [!] returns a _promise_ which is synchronized internally by recorderSupported only for web testing
 
 ### waitForElement
 
@@ -1237,10 +1203,9 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `sec` **[number][10]?** (optional, `1` by default) time in seconds to wait (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][10]?** (optional, `1` by default) time in seconds to wait
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### waitForVisible
 
@@ -1253,10 +1218,9 @@ I.waitForVisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `1`)
 
 ### waitForInvisible
 
@@ -1269,10 +1233,9 @@ I.waitForInvisible('#popup');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `1`)
 
 ### waitForText
 
@@ -1287,11 +1250,10 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 
 #### Parameters
 
--   `text` **[string][5]** to wait for.
+-   `text` **[string][4]** to wait for.
 -   `sec` **[number][10]** (optional, `1` by default) time in seconds to wait (optional, default `1`)
--   `context` **([string][5] \| [object][8])?** (optional) element located by CSS|XPath|strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `context` **([string][4] \| [object][8])?** (optional) element located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### useWebDriverTo
 
@@ -1311,7 +1273,7 @@ I.useWebDriverTo('open multiple windows', async ({ browser }) {
 
 #### Parameters
 
--   `description` **[string][5]** used to show in logs.
+-   `description` **[string][4]** used to show in logs.
 -   `fn` **[function][17]** async functuion that executed with WebDriver helper as argument
 
 ### \_isShadowLocator
@@ -1349,7 +1311,7 @@ this.helpers['WebDriver']._locate({name: 'password'}).then //...
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 -   `smartWait`   (optional, default `false`)
 
 ### \_locateCheckable
@@ -1362,7 +1324,7 @@ this.helpers['WebDriver']._locateCheckable('I agree with terms and conditions').
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 
 ### \_locateClickable
 
@@ -1375,7 +1337,7 @@ const els = await this.helpers.WebDriver._locateClickable('Next page', '.pages')
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 -   `context`  
 
 ### \_locateFields
@@ -1388,7 +1350,7 @@ this.helpers['WebDriver']._locateFields('Your email').then // ...
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 
 ### defineTimeout
 
@@ -1418,9 +1380,9 @@ I.amOnPage('/login'); // opens a login page
 
 #### Parameters
 
--   `url` **[string][5]** url path or global url.
+-   `url` **[string][4]** url path or global url.
 
-Returns **[Promise][4]<any>** 
+Returns **void** automatically synchronized promise with recorder #!
 
 ### forceClick
 
@@ -1451,10 +1413,9 @@ I.forceClick({css: 'nav a.login'});
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** {{ react }}
+-   `locator` **([string][4] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder{{ react }} (optional, default `null`)
 
 ### doubleClick
 
@@ -1470,10 +1431,9 @@ I.doubleClick('.btn.edit');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** {{ react }}
+-   `locator` **([string][4] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder{{ react }} (optional, default `null`)
 
 ### rightClick
 
@@ -1490,10 +1450,9 @@ I.rightClick('Click me', '.context');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** clickable element located by CSS|XPath|strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** {{ react }}
+-   `locator` **([string][4] \| [object][8])** clickable element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder{{ react }} (optional, default `null`)
 
 ### forceRightClick
 
@@ -1514,10 +1473,9 @@ I.forceRightClick('Menu');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** {{ react }}
+-   `locator` **([string][4] \| [object][8])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder{{ react }} (optional, default `null`)
 
 ### clearField
 
@@ -1532,9 +1490,8 @@ I.clearField('#email');
 #### Parameters
 
 -   `field`  
--   `editable` **([string][5] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `editable` **([string][4] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### attachFile
 
@@ -1549,10 +1506,10 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
--   `pathToFile` **[string][5]** local file path relative to codecept.json config file.
-
-Returns **[Promise][4]<any>** Appium: not tested
+-   `locator` **([string][4] \| [object][8])** field located by label|name|CSS|XPath|strict locator.
+-   `pathToFile` **[string][4]** local file path relative to codecept.json config file.
+    [!] returns a _promise_ which is synchronized internally by recorder
+    Appium: not tested
 
 ### uncheckOption
 
@@ -1569,10 +1526,10 @@ I.uncheckOption('agree', '//form');
 
 #### Parameters
 
--   `field` **([string][5] \| [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][5]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** Appium: not tested
+-   `field` **([string][4] \| [object][8])** checkbox located by label | name | CSS | XPath | strict locator.
+-   `context` **([string][4]? | [object][8])** (optional, `null` by default) element located by CSS | XPath | strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
+    Appium: not tested (optional, default `null`)
 
 ### grabHTMLFromAll
 
@@ -1586,9 +1543,9 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `element` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[Array][6]<[string][5]>>** HTML code for an element
+Returns **[Promise][5]<[Array][6]<[string][4]>>** HTML code for an element
 
 ### grabHTMLFrom
 
@@ -1603,9 +1560,9 @@ let postHTML = await I.grabHTMLFrom('#post');
 #### Parameters
 
 -   `locator`  
--   `element` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `element` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][4]<[string][5]>** HTML code for an element
+Returns **[Promise][5]<[string][4]>** HTML code for an element
 
 ### seeTextEquals
 
@@ -1617,10 +1574,9 @@ I.seeTextEquals('text', 'h1');
 
 #### Parameters
 
--   `text` **[string][5]** element value to check.
--   `context` **([string][5] \| [object][8])?** element located by CSS|XPath|strict locator. (optional, default `null`)
-
-Returns **[Promise][4]<any>** 
+-   `text` **[string][4]** element value to check.
+-   `context` **([string][4] \| [object][8])?** element located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### seeElementInDOM
 
@@ -1633,9 +1589,8 @@ I.seeElementInDOM('#modal');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### dontSeeElementInDOM
 
@@ -1647,9 +1602,8 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|Strict locator.
-
-Returns **[Promise][4]<any>** 
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|Strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### seeInSource
 
@@ -1661,9 +1615,8 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 
 #### Parameters
 
--   `text` **[string][5]** value to check.
-
-Returns **[Promise][4]&lt;any>** 
+-   `text` **[string][4]** value to check.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### grabSource
 
@@ -1674,7 +1627,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][4]&lt;[string][5]>** source code
+Returns **[Promise][5]&lt;[string][4]>** source code
 
 ### grabBrowserLogs
 
@@ -1686,7 +1639,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **([Promise][4]&lt;[Array][6]&lt;[object][8]>> | [undefined][19])** all browser logs
+Returns **([Promise][5]&lt;[Array][6]&lt;[object][8]>> | [undefined][19])** all browser logs
 
 ### dontSeeInSource
 
@@ -1699,9 +1652,8 @@ I.dontSeeInSource('<!--'); // no comments in source
 #### Parameters
 
 -   `text`  
--   `value` **[string][5]** to check.
-
-Returns **[Promise][4]&lt;any>** 
+-   `value` **[string][4]** to check.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### seeNumberOfElements
 
@@ -1714,10 +1666,10 @@ I.seeNumberOfElements('#submitBtn', 1);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 -   `num` **[number][10]** number of elements.
-
-Returns **[Promise][4]&lt;any>** {{ react }}
+    [!] returns a _promise_ which is synchronized internally by recorder
+    {{ react }}
 
 ### seeNumberOfVisibleElements
 
@@ -1730,10 +1682,10 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 -   `num` **[number][10]** number of elements.
-
-Returns **[Promise][4]&lt;any>** {{ react }}
+    [!] returns a _promise_ which is synchronized internally by recorder
+    {{ react }}
 
 ### seeAttributesOnElements
 
@@ -1745,10 +1697,9 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 -   `attributes` **[object][8]** attributes and their values to check.
-
-Returns **[Promise][4]&lt;any>** 
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### scrollTo
 
@@ -1762,11 +1713,10 @@ I.scrollTo('#submit', 5, 5);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 -   `offsetX` **[number][10]** (optional, `0` by default) X-axis offset. (optional, default `0`)
--   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset. (optional, default `0`)
-
-Returns **[Promise][4]&lt;any>** 
+-   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `0`)
 
 ### moveCursorTo
 
@@ -1780,13 +1730,12 @@ I.moveCursorTo('#submit', 5,5);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
 -   `xOffset`  
 -   `yOffset`  
 -   `offsetX` **[number][10]** (optional, `0` by default) X-axis offset. (optional, default `0`)
--   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset. (optional, default `0`)
-
-Returns **[Promise][4]&lt;any>** 
+-   `offsetY` **[number][10]** (optional, `0` by default) Y-axis offset.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `0`)
 
 ### saveElementScreenshot
 
@@ -1799,10 +1748,9 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
--   `fileName` **[string][5]** file name to save.
-
-Returns **[Promise][4]&lt;any>** 
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `fileName` **[string][4]** file name to save.
+    [!] returns a _promise_ which is synchronized internally by recorder
 
 ### type
 
@@ -1824,10 +1772,9 @@ I.type(['T', 'E', 'X', 'T']);
 #### Parameters
 
 -   `keys`  
--   `delay` **[number][10]?** (optional) delay in ms between key presses (optional, default `null`)
--   `key` **([string][5] \| [Array][6]&lt;[string][5]>)** or array of keys to type.
-
-Returns **[Promise][4]&lt;any>** 
+-   `delay` **[number][10]?** (optional) delay in ms between key presses
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
+-   `key` **([string][4] \| [Array][6]&lt;[string][4]>)** or array of keys to type.
 
 ### dragAndDrop
 
@@ -1839,10 +1786,10 @@ I.dragAndDrop('#dragHandle', '#container');
 
 #### Parameters
 
--   `srcElement` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
--   `destElement` **([string][5] \| [object][8])** located by CSS|XPath|strict locator.
-
-Returns **[Promise][4]&lt;any>** Appium: not tested
+-   `srcElement` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
+-   `destElement` **([string][4] \| [object][8])** located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder
+    Appium: not tested
 
 ### dragSlider
 
@@ -1856,10 +1803,9 @@ I.dragSlider('#slider', -70);
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** located by label|name|CSS|XPath|strict locator.
--   `offsetX` **[number][10]** position to drag. (optional, default `0`)
-
-Returns **[Promise][4]&lt;any>** 
+-   `locator` **([string][4] \| [object][8])** located by label|name|CSS|XPath|strict locator.
+-   `offsetX` **[number][10]** position to drag.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `0`)
 
 ### grabAllWindowHandles
 
@@ -1870,7 +1816,7 @@ Useful for referencing a specific handle when calling `I.switchToWindow(handle)`
 const windows = await I.grabAllWindowHandles();
 ```
 
-Returns **[Promise][4]&lt;[Array][6]&lt;[string][5]>>** 
+Returns **[Promise][5]&lt;[Array][6]&lt;[string][4]>>** 
 
 ### grabCurrentWindowHandle
 
@@ -1881,7 +1827,7 @@ Useful for referencing it when calling `I.switchToWindow(handle)`
 const window = await I.grabCurrentWindowHandle();
 ```
 
-Returns **[Promise][4]&lt;[string][5]>** 
+Returns **[Promise][5]&lt;[string][4]>** 
 
 ### switchToWindow
 
@@ -1899,7 +1845,7 @@ await I.switchToWindow( window );
 
 #### Parameters
 
--   `window` **[string][5]** name of window handle.
+-   `window` **[string][4]** name of window handle.
 
 ### closeOtherTabs
 
@@ -1909,7 +1855,7 @@ Close all tabs except for the current one.
 I.closeOtherTabs();
 ```
 
-Returns **[Promise][4]&lt;any>** 
+[!] returns a _promise_ which is synchronized internally by recorder
 
 ### switchTo
 
@@ -1922,9 +1868,8 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
--   `locator` **([string][5]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator. (optional, default `null`)
-
-Returns **[Promise][4]&lt;any>** 
+-   `locator` **([string][4]? | [object][8])** (optional, `null` by default) element located by CSS|XPath|strict locator.
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### grabNumberOfOpenTabs
 
@@ -1935,7 +1880,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][4]&lt;[number][10]>** number of open tabs
+Returns **[Promise][5]&lt;[number][10]>** number of open tabs
 
 ### scrollPageToTop
 
@@ -1945,7 +1890,7 @@ Scroll page to the top.
 I.scrollPageToTop();
 ```
 
-Returns **[Promise][4]&lt;any>** 
+[!] returns a _promise_ which is synchronized internally by recorder
 
 ### scrollPageToBottom
 
@@ -1955,7 +1900,7 @@ Scroll page to the bottom.
 I.scrollPageToBottom();
 ```
 
-Returns **[Promise][4]&lt;any>** 
+[!] returns a _promise_ which is synchronized internally by recorder
 
 ### grabPageScrollPosition
 
@@ -1966,7 +1911,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][4]&lt;PageScrollPosition>** scroll position
+Returns **[Promise][5]&lt;PageScrollPosition>** scroll position
 
 ### setGeoLocation
 
@@ -1981,9 +1926,8 @@ I.setGeoLocation(121.21, 11.56, 10);
 
 -   `latitude` **[number][10]** to set.
 -   `longitude` **[number][10]** to set
--   `altitude` **[number][10]?** (optional, null by default) to set (optional, default `null`)
-
-Returns **[Promise][4]&lt;any>** 
+-   `altitude` **[number][10]?** (optional, null by default) to set
+    [!] returns a _promise_ which is synchronized internally by recorder (optional, default `null`)
 
 ### grabGeoLocation
 
@@ -1994,7 +1938,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let geoLocation = await I.grabGeoLocation();
 ```
 
-Returns **[Promise][4]&lt;{latitude: [number][10], longitude: [number][10], altitude: [number][10]}>** 
+Returns **[Promise][5]&lt;{latitude: [number][10], longitude: [number][10], altitude: [number][10]}>** 
 
 ### grabElementBoundingRect
 
@@ -2018,11 +1962,11 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 
 #### Parameters
 
--   `locator` **([string][5] \| [object][8])** element located by CSS|XPath|strict locator.
+-   `locator` **([string][4] \| [object][8])** element located by CSS|XPath|strict locator.
 -   `prop`  
--   `elementSize` **[string][5]?** x, y, width or height of the given element.
+-   `elementSize` **[string][4]?** x, y, width or height of the given element.
 
-Returns **([Promise][4]&lt;DOMRect> | [Promise][4]&lt;[number][10]>)** Element bounding rectangle
+Returns **([Promise][5]&lt;DOMRect> | [Promise][5]&lt;[number][10]>)** Element bounding rectangle
 
 [1]: http://codecept.io/helpers/WebDriver/
 
@@ -2030,9 +1974,9 @@ Returns **([Promise][4]&lt;DOMRect> | [Promise][4]&lt;[number][10]>)** Element b
 
 [3]: https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md
 
-[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
 
-[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
 [6]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array