codeceptjs 3.5.6 → 3.5.7-beta.1

package/docs/helpers/WebDriver.md

@@ -30,18 +30,18 @@ Type: [object][16]
 -   `browser` **[string][17]** Browser in which to perform testing.
 -   `basicAuth` **[string][17]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
 -   `host` **[string][17]?** WebDriver host to connect.
--   `port` **[number][22]?** WebDriver port to connect.
+-   `port` **[number][23]?** WebDriver port to connect.
 -   `protocol` **[string][17]?** protocol for WebDriver server.
 -   `path` **[string][17]?** path to WebDriver server.
 -   `restart` **[boolean][32]?** restart browser between tests.
--   `smartWait` **([boolean][32] | [number][22])?** **enables [SmartWait][36]**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
+-   `smartWait` **([boolean][32] | [number][23])?** **enables [SmartWait][36]**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000.
 -   `disableScreenshots` **[boolean][32]?** don't save screenshots on failure.
 -   `fullPageScreenshots` **[boolean][32]?** (optional - make full page screenshots on failure.
 -   `uniqueScreenshotNames` **[boolean][32]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
 -   `keepBrowserState` **[boolean][32]?** keep browser state between tests when `restart` is set to false.
 -   `keepCookies` **[boolean][32]?** keep cookies between tests when `restart` set to false.
 -   `windowSize` **[string][17]?** default window size. Set to `maximize` or a dimension in the format `640x480`.
--   `waitForTimeout` **[number][22]?** sets default wait time in _ms_ for all `wait*` functions.
+-   `waitForTimeout` **[number][23]?** sets default wait time in _ms_ for all `wait*` functions.
 -   `desiredCapabilities` **[object][16]?** Selenium's [desired capabilities][6].
 -   `manualStart` **[boolean][32]?** do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriver"]._startBrowser()`.
 -   `timeouts` **[object][16]?** [WebDriver timeouts][37] defined as hash.
@@ -456,7 +456,7 @@ I.amOnPage('/login'); // opens a login page
 
 -   `url` **[string][17]** url path or global url.
 
-Returns **void** automatically synchronized promise with recorder #!
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### appendField
 
@@ -473,7 +473,8 @@ I.appendField('password', secret('123456'));
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator
 -   `value` **[string][17]** text value to append.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -494,12 +495,13 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
 
 -   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
 -   `pathToFile` **[string][17]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### blur
 
 Remove focus from a text input, button, etc.
-Calls [blur][19] on the element.
+Calls [blur][20] on the element.
 
 Examples:
 
@@ -517,7 +519,9 @@ I.dontSee('#add-to-cart-btn');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
--   `options` **any?** Playwright only: [Additional options][20] for available options object as 2nd argument.
+-   `options` **any?** Playwright only: [Additional options][21] for available options object as 2nd argument.
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### cancelPopup
 
@@ -539,8 +543,9 @@ I.checkOption('agree', '//form');
 #### Parameters
 
 -   `field` **([string][17] | [object][16])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested 
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### clearCookie
 
@@ -554,8 +559,9 @@ I.clearCookie('test');
 
 #### Parameters
 
--   `cookie` **[string][17]?** (optional, `null` by default) cookie name
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `cookie` **[string][17]?** (optional, `null` by default) cookie name 
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### clearField
 
@@ -571,7 +577,8 @@ I.clearField('#email');
 
 -   `field`  
 -   `editable` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder.
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder.
 
 ### click
 
@@ -600,12 +607,13 @@ I.click({css: 'nav a.login'});
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### closeCurrentTab
 
@@ -615,7 +623,7 @@ Close current tab.
 I.closeCurrentTab();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### closeOtherTabs
 
@@ -625,11 +633,11 @@ Close all tabs except for the current one.
 I.closeOtherTabs();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### defineTimeout
 
-Set [WebDriver timeouts][21] in realtime.
+Set [WebDriver timeouts][22] in realtime.
 
 Timeouts are expected to be passed as object:
 
@@ -655,12 +663,13 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
 #### Parameters
 
 -   `text` **[string][17]** which is not present.
--   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### dontSeeCheckboxIsChecked
 
@@ -675,7 +684,8 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
 #### Parameters
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### dontSeeCookie
 
@@ -688,7 +698,8 @@ I.dontSeeCookie('auth'); // no auth cookie
 #### Parameters
 
 -   `name` **[string][17]** cookie name.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### dontSeeCurrentUrlEquals
 
@@ -703,7 +714,8 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
 #### Parameters
 
 -   `url` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### dontSeeElement
 
@@ -716,7 +728,8 @@ I.dontSeeElement('.modal'); // modal is not shown
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -733,7 +746,8 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### dontSeeInCurrentUrl
 
@@ -742,7 +756,8 @@ Checks that current url does not contain a provided fragment.
 #### Parameters
 
 -   `url` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### dontSeeInField
 
@@ -758,7 +773,8 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
 -   `value` **([string][17] | [object][16])** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]<void>** automatically synchronized promise through #recorder
 
 ### dontSeeInSource
 
@@ -772,7 +788,8 @@ I.dontSeeInSource('<!--'); // no comments in source
 
 -   `text`  
 -   `value` **[string][17]** to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### dontSeeInTitle
 
@@ -785,7 +802,8 @@ I.dontSeeInTitle('Error');
 #### Parameters
 
 -   `text` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### doubleClick
 
@@ -802,12 +820,13 @@ I.doubleClick('.btn.edit');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### dragAndDrop
 
@@ -821,7 +840,8 @@ I.dragAndDrop('#dragHandle', '#container');
 
 -   `srcElement` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 -   `destElement` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### dragSlider
 
@@ -836,15 +856,16 @@ I.dragSlider('#slider', -70);
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
--   `offsetX` **[number][22]** position to drag.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `offsetX` **[number][23]** position to drag. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### executeAsyncScript
 
 Executes async script on page.
 Provided function should execute a passed callback (as first argument) to signal it is finished.
 
-Example: In Vue.js to make components completely rendered we are waiting for [nextTick][23].
+Example: In Vue.js to make components completely rendered we are waiting for [nextTick][24].
 
 ```js
 I.executeAsyncScript(function(done) {
@@ -865,9 +886,9 @@ let val = await I.executeAsyncScript(function(url, done) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
--   `fn` **([string][17] | [function][24])** function to be executed in browser context.
+-   `fn` **([string][17] | [function][25])** function to be executed in browser context.
 
-Returns **[Promise][25]&lt;any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]&lt;any>** script return value
 
 ### executeScript
 
@@ -898,9 +919,9 @@ let date = await I.executeScript(function(el) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
--   `fn` **([string][17] | [function][24])** function to be executed in browser context.
+-   `fn` **([string][17] | [function][25])** function to be executed in browser context.
 
-Returns **[Promise][25]&lt;any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorderWraps [execute][26] command.
+Returns **[Promise][19]&lt;any>** script return valueWraps [execute][26] command.
 
 ### fillField
 
@@ -922,16 +943,17 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
 -   `value` **([string][17] | [object][16])** text value to fill.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
 
-    {{ custom }}
+{{ custom }}
 
 ### focus
 
-Calls [focus][19] on the matching element.
+Calls [focus][20] on the matching element.
 
 Examples:
 
@@ -946,6 +968,8 @@ I.see('#add-to-cart-bnt');
 -   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
 -   `options` **any?** Playwright only: [Additional options][27] for available options object as 2nd argument.
 
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
+
 ### forceClick
 
 Perform an emulated click on a link or a button, given by a locator.
@@ -976,12 +1000,13 @@ I.forceClick({css: 'nav a.login'});
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### forceRightClick
 
@@ -1003,12 +1028,13 @@ I.forceRightClick('Menu');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### grabAllWindowHandles
 
@@ -1019,7 +1045,7 @@ Useful for referencing a specific handle when calling `I.switchToWindow(handle)`
 const windows = await I.grabAllWindowHandles();
 ```
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** 
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** 
 
 ### grabAttributeFrom
 
@@ -1036,7 +1062,7 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][17]** attribute name.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][19]&lt;[string][17]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -1052,7 +1078,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][17]** attribute name.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -1064,7 +1090,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **([Promise][25]&lt;[Array][28]&lt;[object][16]>> | [undefined][29])** all browser logs
+Returns **([Promise][19]&lt;[Array][28]&lt;[object][16]>> | [undefined][29])** all browser logs
 
 ### grabCookie
 
@@ -1081,7 +1107,7 @@ assert(cookie.value, '123456');
 
 -   `name` **[string][17]?** cookie name. 
 
-Returns **([Promise][25]&lt;[string][17]> | [Promise][25]&lt;[Array][28]&lt;[string][17]>>)** attribute value
+Returns **any** attribute value
 
 ### grabCssPropertyFrom
 
@@ -1098,7 +1124,7 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][17]** CSS property name.
 
-Returns **[Promise][25]&lt;[string][17]>** CSS value
+Returns **[Promise][19]&lt;[string][17]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -1114,7 +1140,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][17]** CSS property name.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** CSS value
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -1126,7 +1152,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** current URL
+Returns **[Promise][19]&lt;[string][17]>** current URL
 
 ### grabCurrentWindowHandle
 
@@ -1137,7 +1163,7 @@ Useful for referencing it when calling `I.switchToWindow(handle)`
 const window = await I.grabCurrentWindowHandle();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** 
+Returns **[Promise][19]&lt;[string][17]>** 
 
 ### grabElementBoundingRect
 
@@ -1165,7 +1191,7 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 -   `prop`  
 -   `elementSize` **[string][17]?** x, y, width or height of the given element.
 
-Returns **([Promise][25]&lt;DOMRect> | [Promise][25]&lt;[number][22]>)** Element bounding rectangle
+Returns **([Promise][19]&lt;DOMRect> | [Promise][19]&lt;[number][23]>)** Element bounding rectangle
 
 ### grabGeoLocation
 
@@ -1176,7 +1202,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let geoLocation = await I.grabGeoLocation();
 ```
 
-Returns **[Promise][25]&lt;{latitude: [number][22], longitude: [number][22], altitude: [number][22]}>** 
+Returns **[Promise][19]&lt;{latitude: [number][23], longitude: [number][23], altitude: [number][23]}>** 
 
 ### grabHTMLFrom
 
@@ -1193,7 +1219,7 @@ let postHTML = await I.grabHTMLFrom('#post');
 -   `locator`  
 -   `element` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** HTML code for an element
+Returns **[Promise][19]&lt;[string][17]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -1209,7 +1235,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 -   `locator`  
 -   `element` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** HTML code for an element
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -1220,7 +1246,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][25]&lt;[number][22]>** number of open tabs
+Returns **[Promise][19]&lt;[number][23]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -1235,7 +1261,7 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[number][22]>** number of visible elements
+Returns **[Promise][19]&lt;[number][23]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -1246,7 +1272,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][25]&lt;PageScrollPosition>** scroll position
+Returns **[Promise][19]&lt;PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -1256,7 +1282,7 @@ Grab the text within the popup. If no popup is visible then it will return null.
 await I.grabPopupText();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** 
+Returns **[Promise][19]&lt;[string][17]>** 
 
 ### grabSource
 
@@ -1267,7 +1293,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** source code
+Returns **[Promise][19]&lt;[string][17]>** source code
 
 ### grabTextFrom
 
@@ -1284,7 +1310,7 @@ If multiple elements found returns first element.
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][19]&lt;[string][17]>** attribute value
 
 ### grabTextFromAll
 
@@ -1299,7 +1325,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** attribute value
 
 ### grabTitle
 
@@ -1310,7 +1336,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][25]&lt;[string][17]>** title
+Returns **[Promise][19]&lt;[string][17]>** title
 
 ### grabValueFrom
 
@@ -1326,7 +1352,7 @@ let email = await I.grabValueFrom('input[name=email]');
 
 -   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[string][17]>** attribute value
+Returns **[Promise][19]&lt;[string][17]>** attribute value
 
 ### grabValueFromAll
 
@@ -1341,7 +1367,7 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 -   `locator` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][25]&lt;[Array][28]&lt;[string][17]>>** attribute value
+Returns **[Promise][19]&lt;[Array][28]&lt;[string][17]>>** attribute value
 
 ### moveCursorTo
 
@@ -1358,9 +1384,10 @@ I.moveCursorTo('#submit', 5,5);
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 -   `xOffset`  
 -   `yOffset`  
--   `offsetX` **[number][22]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][22]** (optional, `0` by default) Y-axis offset.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `offsetX` **[number][23]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][23]** (optional, `0` by default) Y-axis offset. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### openNewTab
 
@@ -1370,13 +1397,13 @@ Open new tab and switch to it.
 I.openNewTab();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
-
 #### Parameters
 
 -   `url`   
 -   `windowName`   
 
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
+
 ### pressKey
 
 Presses a key in the browser (on a focused element).
@@ -1441,7 +1468,8 @@ Some of the supported key names are:
 #### Parameters
 
 -   `key` **([string][17] | [Array][28]&lt;[string][17]>)** key or array of keys to press.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder_Note:_ In case a text field or textarea is focused be aware that some browsers do not respect active modifier when combining modifier keys with other keys.
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder_Note:_ In case a text field or textarea is focused be aware that some browsers do not respect active modifier when combining modifier keys with other keys.
 
 ### pressKeyDown
 
@@ -1458,7 +1486,8 @@ I.pressKeyUp('Control');
 #### Parameters
 
 -   `key` **[string][17]** name of key to press down.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### pressKeyUp
 
@@ -1475,7 +1504,8 @@ I.pressKeyUp('Control');
 #### Parameters
 
 -   `key` **[string][17]** name of key to release.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### refreshPage
 
@@ -1485,7 +1515,7 @@ Reload the current page.
 I.refreshPage();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### resizeWindow
 
@@ -1494,9 +1524,10 @@ First parameter can be set to `maximize`.
 
 #### Parameters
 
--   `width` **[number][22]** width in pixels or `maximize`.
--   `height` **[number][22]** height in pixels.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested in web, in apps doesn't work
+-   `width` **[number][23]** width in pixels or `maximize`.
+-   `height` **[number][23]** height in pixels.
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorderAppium: not tested in web, in apps doesn't work
 
 ### rightClick
 
@@ -1514,12 +1545,13 @@ I.rightClick('Click me', '.context');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** clickable element located by CSS|XPath|strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### runInWeb
 
@@ -1560,7 +1592,8 @@ I.saveElementScreenshot(`#submit`,'debug.png');
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `fileName` **[string][17]** file name to save.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### saveScreenshot
 
@@ -1576,8 +1609,9 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 -   `fileName` **[string][17]** file name to save.
--   `fullPage` **[boolean][32]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `fullPage` **[boolean][32]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### scrollIntoView
 
@@ -1593,7 +1627,8 @@ I.scrollIntoView('#submit', { behavior: "smooth", block: "center", inline: "cent
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 -   `scrollIntoViewOptions` **ScrollIntoViewOptions** see [https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoView][33].
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### scrollPageToBottom
 
@@ -1603,7 +1638,7 @@ Scroll page to the bottom.
 I.scrollPageToBottom();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### scrollPageToTop
 
@@ -1613,7 +1648,7 @@ Scroll page to the top.
 I.scrollPageToTop();
 ```
 
-⚠️ returns a _promise_ which is synchronized internally by recorder
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### scrollTo
 
@@ -1628,9 +1663,10 @@ I.scrollTo('#submit', 5, 5);
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
--   `offsetX` **[number][22]** (optional, `0` by default) X-axis offset. 
--   `offsetY` **[number][22]** (optional, `0` by default) Y-axis offset.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `offsetX` **[number][23]** (optional, `0` by default) X-axis offset. 
+-   `offsetY` **[number][23]** (optional, `0` by default) Y-axis offset. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### see
 
@@ -1646,12 +1682,13 @@ I.see('Register', {css: 'form.register'}); // use strict locator
 #### Parameters
 
 -   `text` **[string][17]** expected on page.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
- 
+
 
 ### seeAttributesOnElements
 
@@ -1665,7 +1702,8 @@ I.seeAttributesOnElements('//form', { method: "post"});
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 -   `attributes` **[object][16]** attributes and their values to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeCheckboxIsChecked
 
@@ -1680,7 +1718,8 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
 #### Parameters
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### seeCookie
 
@@ -1693,7 +1732,8 @@ I.seeCookie('Auth');
 #### Parameters
 
 -   `name` **[string][17]** cookie name.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeCssPropertiesOnElements
 
@@ -1707,7 +1747,8 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
 -   `cssProperties` **[object][16]** object with CSS properties and their values to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeCurrentUrlEquals
 
@@ -1723,7 +1764,8 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
 #### Parameters
 
 -   `url` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeElement
 
@@ -1737,7 +1779,8 @@ I.seeElement('#modal');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -1755,7 +1798,8 @@ I.seeElementInDOM('#modal');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeInCurrentUrl
 
@@ -1768,7 +1812,8 @@ I.seeInCurrentUrl('/register'); // we are on registration page
 #### Parameters
 
 -   `url` **[string][17]** a fragment to check
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeInField
 
@@ -1786,7 +1831,8 @@ I.seeInField('#searchform input','Search');
 
 -   `field` **([string][17] | [object][16])** located by label|name|CSS|XPath|strict locator.
 -   `value` **([string][17] | [object][16])** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeInPopup
 
@@ -1808,7 +1854,8 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
 #### Parameters
 
 -   `text` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeInTitle
 
@@ -1821,7 +1868,8 @@ I.seeInTitle('Home Page');
 #### Parameters
 
 -   `text` **[string][17]** text value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeNumberOfElements
 
@@ -1835,8 +1883,9 @@ I.seeNumberOfElements('#submitBtn', 1);
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `num` **[number][23]** number of elements.
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -1854,8 +1903,9 @@ I.seeNumberOfVisibleElements('.buttons', 3);
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `num` **[number][23]** number of elements.
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 
 This action supports [React locators](https://codecept.io/react#locators)
@@ -1872,8 +1922,9 @@ I.seeTextEquals('text', 'h1');
 #### Parameters
 
 -   `text` **[string][17]** element value to check.
--   `context` **([string][17] | [object][16])?** element located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `context` **([string][17] | [object][16])?** element located by CSS|XPath|strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### seeTitleEquals
 
@@ -1886,7 +1937,8 @@ I.seeTitleEquals('Test title.');
 #### Parameters
 
 -   `text` **[string][17]** value to check.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### selectOption
 
@@ -1913,7 +1965,8 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 -   `select` **([string][17] | [object][16])** field located by label|name|CSS|XPath|strict locator.
 -   `option` **([string][17] | [Array][28]&lt;any>)** visible text or value of option.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### setCookie
 
@@ -1934,8 +1987,9 @@ I.setCookie([
 #### Parameters
 
 -   `cookie` **(Cookie | [Array][28]&lt;Cookie>)** a cookie object or array of cookie objects.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderUses Selenium's JSON [cookie
-    format][34].
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorderUses Selenium's JSON [cookie
+format][34].
 
 ### setGeoLocation
 
@@ -1948,10 +2002,11 @@ I.setGeoLocation(121.21, 11.56, 10);
 
 #### Parameters
 
--   `latitude` **[number][22]** to set.
--   `longitude` **[number][22]** to set
--   `altitude` **[number][22]?** (optional, null by default) to set
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `latitude` **[number][23]** to set.
+-   `longitude` **[number][23]** to set
+-   `altitude` **[number][23]?** (optional, null by default) to set 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### switchTo
 
@@ -1964,8 +2019,9 @@ I.switchTo(); // switch back to main page
 
 #### Parameters
 
--   `locator` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `locator` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### switchToNextTab
 
@@ -1978,9 +2034,10 @@ I.switchToNextTab(2);
 
 #### Parameters
 
--   `num` **[number][22]?** (optional) number of tabs to switch forward, default: 1. 
--   `sec` **([number][22] | null)?** (optional) time in seconds to wait.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `num` **[number][23]?** (optional) number of tabs to switch forward, default: 1. 
+-   `sec` **([number][23] | null)?** (optional) time in seconds to wait. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### switchToPreviousTab
 
@@ -1993,9 +2050,10 @@ I.switchToPreviousTab(2);
 
 #### Parameters
 
--   `num` **[number][22]?** (optional) number of tabs to switch backward, default: 1. 
--   `sec` **[number][22]??** (optional) time in seconds to wait.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `num` **[number][23]?** (optional) number of tabs to switch backward, default: 1. 
+-   `sec` **[number][23]??** (optional) time in seconds to wait. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### switchToWindow
 
@@ -2038,10 +2096,11 @@ I.type(secret('123456'));
 #### Parameters
 
 -   `keys`  
--   `delay` **[number][22]?** (optional) delay in ms between key presses
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `delay` **[number][23]?** (optional) delay in ms between key presses 
 -   `key` **([string][17] | [Array][28]&lt;[string][17]>)** or array of keys to type.
 
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
+
 ### uncheckOption
 
 Unselects a checkbox or radio button.
@@ -2058,8 +2117,9 @@ I.uncheckOption('agree', '//form');
 #### Parameters
 
 -   `field` **([string][17] | [object][16])** checkbox located by label | name | CSS | XPath | strict locator.
--   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderAppium: not tested 
+-   `context` **([string][17]? | [object][16])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorderAppium: not tested
 
 ### useWebDriverTo
 
@@ -2080,7 +2140,7 @@ I.useWebDriverTo('open multiple windows', async ({ browser }) {
 #### Parameters
 
 -   `description` **[string][17]** used to show in logs.
--   `fn` **[function][24]** async functuion that executed with WebDriver helper as argument
+-   `fn` **[function][25]** async functuion that executed with WebDriver helper as argument
 
 ### wait
 
@@ -2092,8 +2152,9 @@ I.wait(2); // wait 2 secs
 
 #### Parameters
 
--   `sec` **[number][22]** number of second to wait.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `sec` **[number][23]** number of second to wait.
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForClickable
 
@@ -2109,8 +2170,9 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
 -   `waitTimeout`  
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForDetached
 
@@ -2124,8 +2186,9 @@ I.waitForDetached('#popup');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForElement
 
@@ -2140,8 +2203,9 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForEnabled
 
@@ -2151,8 +2215,9 @@ Element can be located by CSS or XPath.
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional) time in seconds to wait, 1 by default.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional) time in seconds to wait, 1 by default. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForFunction
 
@@ -2171,10 +2236,11 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][17] | [function][24])** to be executed in browser context.
--   `argsOrSec` **([Array][28]&lt;any> | [number][22])?** (optional, `1` by default) arguments for function or seconds. 
--   `sec` **[number][22]?** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `fn` **([string][17] | [function][25])** to be executed in browser context.
+-   `argsOrSec` **([Array][28]&lt;any> | [number][23])?** (optional, `1` by default) arguments for function or seconds. 
+-   `sec` **[number][23]?** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForInvisible
 
@@ -2188,8 +2254,9 @@ I.waitForInvisible('#popup');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForText
 
@@ -2205,9 +2272,10 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
 #### Parameters
 
 -   `text` **[string][17]** to wait for.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait 
--   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+-   `context` **([string][17] | [object][16])?** (optional) element located by CSS|XPath|strict locator. 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForValue
 
@@ -2221,8 +2289,9 @@ I.waitForValue('//input', "GoodValue");
 
 -   `field` **([string][17] | [object][16])** input field.
 -   `value` **[string][17]** expected value.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitForVisible
 
@@ -2236,8 +2305,9 @@ I.waitForVisible('#popup');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitInUrl
 
@@ -2250,8 +2320,9 @@ I.waitInUrl('/info', 2);
 #### Parameters
 
 -   `urlPart` **[string][17]** value to check.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitNumberOfVisibleElements
 
@@ -2264,9 +2335,10 @@ I.waitNumberOfVisibleElements('a', 3);
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `num` **[number][22]** number of elements.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `num` **[number][23]** number of elements.
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitToHide
 
@@ -2280,8 +2352,9 @@ I.waitToHide('#popup');
 #### Parameters
 
 -   `locator` **([string][17] | [object][16])** element located by CSS|XPath|strict locator.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 ### waitUrlEquals
 
@@ -2295,8 +2368,9 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 #### Parameters
 
 -   `urlPart` **[string][17]** value to check.
--   `sec` **[number][22]** (optional, `1` by default) time in seconds to wait
-    ⚠️ returns a _promise_ which is synchronized internally by recorder 
+-   `sec` **[number][23]** (optional, `1` by default) time in seconds to wait 
+
+Returns **[Promise][19]&lt;void>** automatically synchronized promise through #recorder
 
 [1]: http://webdriver.io/
 
@@ -2334,19 +2408,19 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [18]: http://jster.net/category/windows-modals-popups
 
-[19]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
+[19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[20]: https://playwright.dev/docs/api/class-locator#locator-blur
+[20]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
 
-[21]: https://webdriver.io/docs/timeouts.html
+[21]: https://playwright.dev/docs/api/class-locator#locator-blur
 
-[22]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[22]: https://webdriver.io/docs/timeouts.html
 
-[23]: https://vuejs.org/v2/api/#Vue-nextTick
+[23]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[24]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[24]: https://vuejs.org/v2/api/#Vue-nextTick
 
-[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
 [26]: http://webdriver.io/api/protocol/execute.html