codeceptjs 3.0.3 → 3.0.7

package/docs/email.md

@@ -6,10 +6,10 @@ title: Email Testing
 # Email Testing
 
 In End 2 End testing we need to interact with emails.
-Email delivery can't tested locally or mocked while testing.
-That's why for an end to end test you need to use a real emails to be sent and real email address to receive that emails.
+Email delivery can't be tested locally or mocked while testing.
+That's why for an end to end test you need real emails to be sent and real email address to receive that emails.
 
-Setting up an email server can be hard. So we recommend to use a [MailSlurp](https://mailslurp.com/) - a service designed for testing emails. It creates disposable mailboxes and provides you an access to those mailboxes via REST API.
+Setting up an email server can be hard. So we recommend to use [MailSlurp](https://mailslurp.com/) - a service designed for testing emails. It creates disposable mailboxes and provides you an access to those mailboxes via REST API.
 
 > You no longer need to open your gmail account in a browser to check for an email!
 
@@ -41,7 +41,7 @@ npx codeceptjs def
 
 ## Creating Mailbox
 
-MailSlurp allows you to create disposable mailboxes. It means that an email address is created for a one test only and is deleted afterwards. So you can be confident that no other emails are received at that address.
+MailSlurp allows you to create disposable mailboxes. It means that an email address is created for one test only and is deleted afterwards. So you can be confident that no other emails are received at that address.
 
 To create a mailbox use `I.haveNewMailbox()` command:
 
@@ -57,7 +57,7 @@ mailbox object contains:
 
 > See [MailSlurp's guide](https://www.mailslurp.com/guides/getting-started/#create-email-addresses) for details.
 
-Mailbox is opened on creation. If you need more than one mailboxes and you want to switch between them use `openMailbox` method:
+Mailbox is opened on creation. If you need more than one mailbox and you want to switch between them use `openMailbox` method:
 
 ```js
 const mailbox1 = await I.haveNewMailbox();
@@ -71,7 +71,7 @@ I.openMailbox(mailbox1);
 
 A last created mailbox will be activated. It means that it will be used by default to check for emails.
 
-After an action that triggers sending an email is performed on a website you should wait for this email to be received.
+After an action that triggers sending an email is performed on a website, you should wait for this email to be received.
 A timeout for waiting an email can be set globally for a helper or for a one call.
 
 Use `waitForLatestEmail` function to return the first email from a mailbox:
@@ -109,7 +109,7 @@ const email = await I.waitForLatestEmail();
 ```
 > Please note, that we use `await` to assign email. This should be declared inside async function
 
-An `email` object contains following fields:
+An `email` object contains the following fields:
 
 * `subject`
 * `for`
@@ -130,7 +130,7 @@ I.amOnPage(url);
 
 ## Assertions
 
-Assertions are performed on the currently opened email.Email is opened on `waitFor` email call, however, you can open an exact email by using `openEmail` function.
+Assertions are performed on the currently opened email. Email is opened on `waitFor` email call, however, you can open an exact email by using `openEmail` function.
 
 ```js
 const email1 = await I.waitForLatestEmail();

package/docs/helpers/Appium.md

@@ -911,7 +911,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][4] \| [object][6])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][4]** text value to fill.
+-   `value` **([string][4] \| [object][6])** text value to fill.
 
 ### grabTextFromAll
 

package/docs/helpers/Nightmare.md

@@ -415,7 +415,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][3]** text value to fill.
+-   `value` **([string][3] | [object][4])** text value to fill.
 
 ### grabAttributeFrom
 
@@ -653,19 +653,18 @@ Returns **[Promise][8]<[string][3]>** attribute value
 
 ### grabValueFromAll
 
-Retrieves a value from a form element located by CSS or XPath and returns it to test.
+Retrieves an array of value from a form located by CSS or XPath and returns it to test.
 Resumes test execution, so **should be used inside async function with `await`** operator.
-If more than one element is found - value of first element is returned.
 
 ```js
-let email = await I.grabValueFrom('input[name=email]');
+let inputs = await I.grabValueFromAll('//form/input');
 ```
 
 #### Parameters
 
 -   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][8]<[string][3]>** attribute value
+Returns **[Promise][8]<[Array][10]<[string][3]>>** attribute value
 
 ### haveHeader
 

package/docs/helpers/Playwright.md

@@ -28,7 +28,7 @@ Requires `playwright` package version ^1 to be installed:
 This helper should be configured in codecept.json or codecept.conf.js
 
 -   `url`: base url of website to be tested
--   `browser`: a browser to test on, either: `chromium`, `firefox`, `webkit`. Default: chromium.
+-   `browser`: a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
 -   `show`:  - show browser window.
 -   `restart`:  - restart browser between tests.
 -   `disableScreenshots`:   - don't save screenshot on failure.
@@ -47,6 +47,7 @@ This helper should be configured in codecept.json or codecept.conf.js
 -   `userAgent`: (optional) user-agent string.
 -   `manualStart`:  - do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
 -   `chromium`: (optional) pass additional chromium options
+-   `electron`: (optional) pass additional electron options
 
 #### Example #1: Wait for 0 network connections.
 
@@ -99,7 +100,7 @@ This helper should be configured in codecept.json or codecept.conf.js
      Playwright: {
        url: "http://localhost",
        chromium: {
-         browserWSEndpoint: "ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a"
+         browserWSEndpoint: { wsEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a' }
        }
      }
    }
@@ -117,6 +118,7 @@ This helper should be configured in codecept.json or codecept.conf.js
      url: "http://localhost",
      show: true // headless mode not supported for extensions
      chromium: {
+       userDataDir: '/tmp/playwright-tmp', // necessary to launch the browser in normal mode instead of incognito,
        args: [
           `--disable-extensions-except=${pathToExtension}`,
           `--load-extension=${pathToExtension}`
@@ -174,6 +176,14 @@ Add the 'dialog' event listener to a page
 
 -   `page`  
 
+### _contextLocator
+
+Grab Locator if called within Context
+
+#### Parameters
+
+-   `locator` **any** 
+
 ### _getPageUrl
 
 Gets page URL including hash.
@@ -612,8 +622,10 @@ If a function returns a Promise it will wait for its resolution.
 
 #### Parameters
 
--   `fn`  
--   `arg`  
+-   `fn` **([string][7] | [function][9])** function to be executed in browser context.
+-   `arg` **any?** optional argument to pass to the function
+
+Returns **[Promise][10]<any>** 
 
 ### fillField
 
@@ -634,21 +646,39 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][7] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][7]** text value to fill.
+-   `value` **([string][7] | [object][5])** text value to fill.
 
 ### forceClick
 
-Force clicks an element without waiting for it to become visible and not animating.
+Perform an emulated click on a link or a button, given by a locator.
+Unlike normal click instead of sending native event, emulates a click with JavaScript.
+This works on hidden, animated or inactive elements as well.
+
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
 
 ```js
-I.forceClick('#hiddenButton');
-I.forceClick('Click me', '#hidden');
+// simple link
+I.forceClick('Logout');
+// button of form
+I.forceClick('Submit');
+// CSS button
+I.forceClick('#form input[type=submit]');
+// XPath
+I.forceClick('//form/*[@type=submit]');
+// link in context
+I.forceClick('Logout', '#nav');
+// using strict locator
+I.forceClick({css: 'nav a.login'});
 ```
 
 #### Parameters
 
--   `locator`  
--   `context`   
+-   `locator` **([string][7] | [object][5])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+-   `context` **([string][7]? | [object][5])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
 
 ### grabAttributeFrom
 
@@ -665,7 +695,7 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][7]** attribute name.
 
-Returns **[Promise][9]<[string][7]>** attribute value
+Returns **[Promise][10]<[string][7]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -681,7 +711,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][7]** attribute name.
 
-Returns **[Promise][9]<[Array][10]<[string][7]>>** attribute value
+Returns **[Promise][10]<[Array][11]<[string][7]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -692,7 +722,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **[Promise][9]<[Array][10]<any>>** 
+Returns **[Promise][10]<[Array][11]<any>>** 
 
 ### grabCookie
 
@@ -709,7 +739,7 @@ assert(cookie.value, '123456');
 
 -   `name` **[string][7]?** cookie name. 
 
-Returns **([Promise][9]<[string][7]> | [Promise][9]<[Array][10]<[string][7]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
+Returns **([Promise][10]<[string][7]> | [Promise][10]<[Array][11]<[string][7]>>)** attribute valueReturns cookie in JSON format. If name not passed returns all cookies for this domain.
 
 ### grabCssPropertyFrom
 
@@ -726,7 +756,7 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][7]** CSS property name.
 
-Returns **[Promise][9]<[string][7]>** CSS value
+Returns **[Promise][10]<[string][7]>** CSS value
 
 ### grabCssPropertyFromAll
 
@@ -742,7 +772,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][7]** CSS property name.
 
-Returns **[Promise][9]<[Array][10]<[string][7]>>** CSS value
+Returns **[Promise][10]<[Array][11]<[string][7]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -754,7 +784,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][9]<[string][7]>** current URL
+Returns **[Promise][10]<[string][7]>** current URL
 
 ### grabDataFromPerformanceTiming
 
@@ -805,7 +835,7 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 -   `prop`  
 -   `elementSize` **[string][7]?** x, y, width or height of the given element.
 
-Returns **([Promise][9]<DOMRect> | [Promise][9]<[number][8]>)** Element bounding rectangle
+Returns **([Promise][10]<DOMRect> | [Promise][10]<[number][8]>)** Element bounding rectangle
 
 ### grabHTMLFrom
 
@@ -822,7 +852,7 @@ let postHTML = await I.grabHTMLFrom('#post');
 -   `locator`  
 -   `element` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][7]>** HTML code for an element
+Returns **[Promise][10]<[string][7]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -838,7 +868,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 -   `locator`  
 -   `element` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][7]>>** HTML code for an element
+Returns **[Promise][10]<[Array][11]<[string][7]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -849,7 +879,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let tabs = await I.grabNumberOfOpenTabs();
 ```
 
-Returns **[Promise][9]<[number][8]>** number of open tabs
+Returns **[Promise][10]<[number][8]>** number of open tabs
 
 ### grabNumberOfVisibleElements
 
@@ -864,7 +894,7 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 -   `locator` **([string][7] | [object][5])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[number][8]>** number of visible elements
+Returns **[Promise][10]<[number][8]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -875,7 +905,7 @@ Resumes test execution, so **should be used inside an async function with `await
 let { x, y } = await I.grabPageScrollPosition();
 ```
 
-Returns **[Promise][9]<PageScrollPosition>** scroll position
+Returns **[Promise][10]<PageScrollPosition>** scroll position
 
 ### grabPopupText
 
@@ -885,7 +915,7 @@ Grab the text within the popup. If no popup is visible then it will return null
 await I.grabPopupText();
 ```
 
-Returns **[Promise][9]<([string][7] | null)>** 
+Returns **[Promise][10]<([string][7] | null)>** 
 
 ### grabSource
 
@@ -896,7 +926,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let pageSource = await I.grabSource();
 ```
 
-Returns **[Promise][9]<[string][7]>** source code
+Returns **[Promise][10]<[string][7]>** source code
 
 ### grabTextFrom
 
@@ -913,7 +943,7 @@ If multiple elements found returns first element.
 
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][7]>** attribute value
+Returns **[Promise][10]<[string][7]>** attribute value
 
 ### grabTextFromAll
 
@@ -928,7 +958,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 -   `locator` **([string][7] | [object][5])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][7]>>** attribute value
+Returns **[Promise][10]<[Array][11]<[string][7]>>** attribute value
 
 ### grabTitle
 
@@ -939,7 +969,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][9]<[string][7]>** title
+Returns **[Promise][10]<[string][7]>** title
 
 ### grabValueFrom
 
@@ -955,7 +985,7 @@ let email = await I.grabValueFrom('input[name=email]');
 
 -   `locator` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][7]>** attribute value
+Returns **[Promise][10]<[string][7]>** attribute value
 
 ### grabValueFromAll
 
@@ -970,14 +1000,14 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 -   `locator` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][7]>>** attribute value
+Returns **[Promise][10]<[Array][11]<[string][7]>>** attribute value
 
 ### handleDownloads
 
 Handles a file download.Aa file name is required to save the file on disk.
 Files are saved to "output" directory.
 
-Should be used with [FileSystem helper][11] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][12] to check that file were downloaded correctly.
 
 ```js
 I.handleDownloads('downloads/avatar.jpg');
@@ -1028,7 +1058,7 @@ Open new tab and automatically switched to new tab
 I.openNewTab();
 ```
 
-You can pass in [page options][12] to emulate device on this page
+You can pass in [page options][13] to emulate device on this page
 
 ```js
 // enable mobile
@@ -1043,7 +1073,7 @@ I.openNewTab({ isMobile: true });
 
 Presses a key in the browser (on a focused element).
 
-_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][13].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][14].
 
 ```js
 I.pressKey('Backspace');
@@ -1102,13 +1132,13 @@ Some of the supported key names are:
 
 #### Parameters
 
--   `key` **([string][7] | [Array][10]<[string][7]>)** key or array of keys to press._Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][14]).
+-   `key` **([string][7] | [Array][11]<[string][7]>)** key or array of keys to press._Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][15]).
 
 ### pressKeyDown
 
 Presses a key in the browser and leaves it in a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][15]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][16]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1124,7 +1154,7 @@ I.pressKeyUp('Control');
 
 Releases a key in the browser which was previously set to a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][15]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][16]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1206,7 +1236,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 -   `fileName` **[string][7]** file name to save.
--   `fullPage` **[boolean][16]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+-   `fullPage` **[boolean][17]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 ### scrollPageToBottom
 
@@ -1466,7 +1496,7 @@ I.seeTitleEquals('Test title.');
 
 #### Parameters
 
--   `text`  
+-   `text` **[string][7]** value to check.
 
 ### selectOption
 
@@ -1492,7 +1522,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 #### Parameters
 
 -   `select` **([string][7] | [object][5])** field located by label|name|CSS|XPath|strict locator.
--   `option` **([string][7] | [Array][10]<any>)** visible text or value of option.
+-   `option` **([string][7] | [Array][11]<any>)** visible text or value of option.
 
 ### setCookie
 
@@ -1512,7 +1542,7 @@ I.setCookie([
 
 #### Parameters
 
--   `cookie` **(Cookie | [Array][10]<Cookie>)** a cookie object or array of cookie objects.
+-   `cookie` **(Cookie | [Array][11]<Cookie>)** a cookie object or array of cookie objects.
 
 ### switchTo
 
@@ -1557,7 +1587,7 @@ I.switchToPreviousTab(2);
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-_Note:_ Should be used when [`fillField`][13] is not an option.
+_Note:_ Should be used when [`fillField`][14] is not an option.
 
 ```js
 // passing in a string
@@ -1574,7 +1604,7 @@ I.type(['T', 'E', 'X', 'T']);
 
 -   `keys`  
 -   `delay` **[number][8]?** (optional) delay in ms between key presses 
--   `key` **([string][7] | [Array][10]<[string][7]>)** or array of keys to type.
+-   `key` **([string][7] | [Array][11]<[string][7]>)** or array of keys to type.
 
 ### uncheckOption
 
@@ -1601,7 +1631,7 @@ Use Playwright API inside a test.
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`page`][17], [`context`][18] [`browser`][19] } objects from Playwright API are available.
+{ [`page`][18], [`context`][19] [`browser`][20] } objects from Playwright API are available.
 
 ```js
 I.usePlaywrightTo('emulate offline mode', async ({ context }) {
@@ -1612,7 +1642,7 @@ I.usePlaywrightTo('emulate offline mode', async ({ context }) {
 #### Parameters
 
 -   `description` **[string][7]** used to show in logs.
--   `fn` **[function][20]** async functuion that executed with Playwright helper as argument
+-   `fn` **[function][9]** async functuion that executed with Playwright helper as argument
 
 ### wait
 
@@ -1698,8 +1728,8 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][7] | [function][20])** to be executed in browser context.
--   `argsOrSec` **([Array][10]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
+-   `fn` **([string][7] | [function][9])** to be executed in browser context.
+-   `argsOrSec` **([Array][11]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
 -   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait 
 
 ### waitForInvisible
@@ -1720,7 +1750,7 @@ I.waitForInvisible('#popup');
 
 Waits for navigation to finish. By default takes configured `waitForNavigation` option.
 
-See [Pupeteer's reference][21]
+See [Playwright's reference][21]
 
 #### Parameters
 
@@ -1737,7 +1767,7 @@ I.waitForRequest(request => request.url() === 'http://example.com' && request.me
 
 #### Parameters
 
--   `urlOrPredicate` **([string][7] | [function][20])** 
+-   `urlOrPredicate` **([string][7] | [function][9])** 
 -   `sec` **[number][8]?** seconds to wait 
 
 ### waitForResponse
@@ -1751,7 +1781,7 @@ I.waitForResponse(request => request.url() === 'http://example.com' && request.m
 
 #### Parameters
 
--   `urlOrPredicate` **([string][7] | [function][20])** 
+-   `urlOrPredicate` **([string][7] | [function][9])** 
 -   `sec` **[number][8]?** number of seconds to wait 
 
 ### waitForText
@@ -1851,7 +1881,7 @@ I.waitUntil(() => window.requests == 0, 5);
 
 #### Parameters
 
--   `fn` **([function][20] | [string][7])** function which is executed in browser context.
+-   `fn` **([function][9] | [string][7])** function which is executed in browser context.
 -   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
 -   `timeoutMsg` **[string][7]** message to show in case of timeout fail. 
 -   `interval` **[number][8]?**  
@@ -1874,7 +1904,7 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [2]: https://github.com/microsoft/playwright/blob/master/docs/api.md#pagewaitfornavigationoptions
 
-[3]: https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target
+[3]: https://playwright.dev/docs/api/class-browsertype#browsertypeconnectparams
 
 [4]: https://github.com/microsoft/playwright/blob/v0.11.0/docs/api.md#working-with-chrome-extensions
 
@@ -1886,30 +1916,30 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
 
-[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[11]: https://codecept.io/helpers/FileSystem
+[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[12]: https://github.com/microsoft/playwright/blob/master/docs/api.md#browsernewpageoptions
+[12]: https://codecept.io/helpers/FileSystem
 
-[13]: #fillfield
+[13]: https://github.com/microsoft/playwright/blob/master/docs/api.md#browsernewpageoptions
 
-[14]: https://github.com/GoogleChrome/puppeteer/issues/1313
+[14]: #fillfield
 
-[15]: #click
+[15]: https://github.com/GoogleChrome/puppeteer/issues/1313
 
-[16]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[16]: #click
 
-[17]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-page
+[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[18]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-context
+[18]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-page
 
-[19]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-browser
+[19]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-context
 
-[20]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[20]: https://github.com/microsoft/playwright/blob/master/docs/api.md#class-browser
 
-[21]: https://github.com/microsoft/Playwright/blob/master/docs/api.md#pagewaitfornavigationoptions
+[21]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
 
 [22]: https://codecept.io/react

package/docs/helpers/Protractor.md

@@ -563,7 +563,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][9] | [object][10])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][9]** text value to fill.
+-   `value` **([string][9] | [object][10])** text value to fill.
 
 ### grabAttributeFrom
 

package/docs/helpers/Puppeteer.md

@@ -690,7 +690,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][8] | [object][6])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][8]** text value to fill.
+-   `value` **([string][8] | [object][6])** text value to fill.
 
 
 This action supports [React locators](https://codecept.io/react#locators)

package/docs/helpers/REST.md

@@ -101,6 +101,9 @@ Sends PATCH request to API.
 
 ```js
 I.sendPatchRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPatchRequest('/api/users.json', secret({ "email": "user@user.com" }));
 ```
 
 #### Parameters
@@ -115,6 +118,9 @@ Sends POST request to API.
 
 ```js
 I.sendPostRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPostRequest('/api/users.json', secret({ "email": "user@user.com" }));
 ```
 
 #### Parameters
@@ -129,6 +135,9 @@ Sends PUT request to API.
 
 ```js
 I.sendPutRequest('/api/users.json', { "email": "user@user.com" });
+
+// To mask the payload in logs
+I.sendPutRequest('/api/users.json', secret({ "email": "user@user.com" }));
 ```
 
 #### Parameters

package/docs/helpers/TestCafe.md

@@ -399,7 +399,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][4] | [object][5])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][4]** text value to fill.
+-   `value` **([string][4] | [object][5])** text value to fill.
 
 ### grabAttributeFrom
 

package/docs/helpers/WebDriver.md

@@ -868,11 +868,12 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
 #### Parameters
 
 -   `field` **([string][19] | [object][18])** located by label|name|CSS|XPath|strict locator.
--   `value` **[string][19]** text value to fill.
+-   `value` **([string][19] | [object][18])** text value to fill.
 
 
 This action supports [React locators](https://codecept.io/react#locators)
 
+    {{ custom }}
 
 ### forceClick