codeceptjs 3.0.4 → 3.0.5

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+## 3.0.5
+
+
+Features:
+
+* **[Official Docker image for CodeceptJS v3](https://hub.docker.com/r/codeceptjs/codeceptjs)**. New Docker image is based on official Playwright image and supports Playwright, Puppeteer, WebDriver engines. Thanks @VikentyShevyrin  
+* Better support for Typescript `codecept.conf.ts` configuration files. See #2750 by @elaichenkov
+* Propagate more events for custom parallel script. See #2796 by @jccguimaraes 
+* [mocha-junit-reporter] Now supports attachments, see documentation for details. See #2675 by @Shard
+* CustomLocators interface for TypeScript to extend from LocatorOrString. See #2798 by @danielrentz
+* [REST] Mask sensitive data from log messages.
+```js
+I.sendPatchRequest('/api/users.json', secret({ "email": "user@user.com" }));
+```
+See #2786 by @PeterNgTr
+
+Bug fixes:
+* Fixed reporting of nested steps with PageObjects and BDD scenarios. See #2800 by @davertmik. Fixes #2720 #2682
+* Fixed issue with `codeceptjs shell` which was broken since 3.0.0. See #2743 by @stedman
+* [Gherkin] Fixed issue suppressed or hidden errors in tests. See #2745 by @ktryniszewski-mdsol
+* [Playwright] fix grabCssPropertyFromAll serialization by using property names. See #2757 by @elaichenkov
+* [Allure] fix report for multi sessions. See #2771 by @cbayer97
+* [WebDriver] Fix locator object debug log messages in smart wait. See 2748 by @elaichenkov
+
+Documentation fixes:
+* Fixed some broken examples. See #2756 by @danielrentz
+* Fixed Typescript typings. See #2747, #2758 and #2769 by @elaichenkov
+* Added missing type for xFeature. See #2754 by @PeterNgTr
+* Fixed code example in Page Object documentation. See #2793 by @mkrtchian
+
+Library updates:
+* Updated Axios to 0.21.1. See by @sseide
+* Updated @pollyjs/core @pollyjs/adapter-puppeteer. See #2760 by @Anikethana
+
 ## 3.0.4
 
 * **Hotfix** Fixed `init` script by adding `cross-spawn` package. By @vipulgupta2048

package/docs/build/Appium.js

@@ -1414,7 +1414,7 @@ class Appium extends Webdriver {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    *
    */

package/docs/build/Nightmare.js

@@ -966,7 +966,7 @@ class Nightmare extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    */
   async fillField(field, value) {
@@ -1180,15 +1180,14 @@ class Nightmare extends Helper {
   }
 
   /**
-   * 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');
    * ```
    * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
-   * @returns {Promise<string>} attribute value
+   * @returns {Promise<string[]>} attribute value
    * 
    */
   async grabValueFromAll(locator) {

package/docs/build/Playwright.js

@@ -878,11 +878,14 @@ class Playwright extends Helper {
   }
 
   /**
-   * Checks that title is equal to provided one.
-   *
-   * ```js
-   * I.seeTitleEquals('Test title.');
-   * ```
+   *  Checks that title is equal to provided one.
+   * 
+   *  ```js
+   *  I.seeTitleEquals('Test title.');
+   *  ```
+   * 
+   *  @param {string} text value to check.
+   * 
    */
   async seeTitleEquals(text) {
     const title = await this.page.title();
@@ -1217,14 +1220,34 @@ class Playwright extends Helper {
   }
 
   /**
-   *
-   * 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'});
    * ```
-   *
+   * 
+   * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+   * 
    */
   async forceClick(locator, context = null) {
     return proceedClick.call(this, locator, context, { force: true });
@@ -1530,7 +1553,7 @@ class Playwright extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    *
    */
@@ -2043,6 +2066,10 @@ class Playwright extends Helper {
    * I.executeScript(([x, y]) => x + y, [x, y]);
    * ```
    * If a function returns a Promise it will wait for its resolution.
+   *
+   * @param {string|function} fn function to be executed in browser context.
+   * @param {any} [arg] optional argument to pass to the function
+   * @return {Promise<any>}
    */
   async executeScript(fn, arg) {
     let context = this.page;
@@ -2209,8 +2236,7 @@ class Playwright extends Helper {
   async grabCssPropertyFromAll(locator, cssProperty) {
     const els = await this._locate(locator);
     this.debug(`Matched ${els.length} elements`);
-    const res = await Promise.all(els.map(el => el.$eval('xpath=.', el => JSON.parse(JSON.stringify(getComputedStyle(el))), el)));
-    const cssValues = res.map(props => props[toCamelCase(cssProperty)]);
+    const cssValues = await Promise.all(els.map(el => el.$eval('xpath=.', (el, cssProperty) => getComputedStyle(el).getPropertyValue(cssProperty), cssProperty)));
 
     return cssValues;
   }
@@ -2882,7 +2908,7 @@ class Playwright extends Helper {
   /**
    * Waits for navigation to finish. By default takes configured `waitForNavigation` option.
    *
-   * See [Pupeteer's reference](https://github.com/microsoft/Playwright/blob/master/docs/api.md#pagewaitfornavigationoptions)
+   * See [Playwright's reference](https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions)
    *
    * @param {*} opts
    */

package/docs/build/Protractor.js

@@ -723,7 +723,7 @@ class Protractor extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    */
   async fillField(field, value) {

package/docs/build/Puppeteer.js

@@ -1593,7 +1593,7 @@ class Puppeteer extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    * {{ react }}
    */

package/docs/build/REST.js

@@ -1,4 +1,5 @@
 const axios = require('axios').default;
+const Secret = require('../secret');
 
 const Helper = require('../helper');
 
@@ -75,12 +76,18 @@ class REST extends Helper {
    * @param {*} request
    */
   async _executeRequest(request) {
+    const _debugRequest = { ...request };
     axios.defaults.timeout = request.timeout || this.options.timeout;
 
     if (this.headers && this.headers.auth) {
       request.auth = this.headers.auth;
     }
 
+    if (request.data instanceof Secret) {
+      _debugRequest.data = '*****';
+      request.data = typeof request.data === 'object' ? { ...request.data.toString() } : request.data.toString();
+    }
+
     if ((typeof request.data) === 'string') {
       if (!request.headers || !request.headers['Content-Type']) {
         request.headers = { ...request.headers, ...{ 'Content-Type': 'application/x-www-form-urlencoded' } };
@@ -91,7 +98,7 @@ class REST extends Helper {
       await this.config.onRequest(request);
     }
 
-    this.debugSection('Request', JSON.stringify(request));
+    this.debugSection('Request', JSON.stringify(_debugRequest));
 
     let response;
     try {
@@ -149,6 +156,10 @@ class REST extends Helper {
    *
    * ```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" }));
+   *
    * ```
    *
    * @param {*} url
@@ -176,6 +187,10 @@ class REST extends Helper {
    *
    * ```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" }));
+   *
    * ```
    *
    * @param {string} url
@@ -203,6 +218,10 @@ class REST extends Helper {
    *
    * ```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" }));
+   *
    * ```
    *
    * @param {string} url

package/docs/build/TestCafe.js

@@ -440,7 +440,7 @@ class TestCafe extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    */
   async fillField(field, value) {

package/docs/build/WebDriver.js

@@ -718,7 +718,7 @@ class WebDriver extends Helper {
    * @param {object} locator
    */
   async _smartWait(locator) {
-    this.debugSection(`SmartWait (${this.options.smartWait}ms)`, `Locating ${locator} in ${this.options.smartWait}`);
+    this.debugSection(`SmartWait (${this.options.smartWait}ms)`, `Locating ${JSON.stringify(locator)} in ${this.options.smartWait}`);
     await this.defineTimeout({ implicit: this.options.smartWait });
   }
 
@@ -1076,7 +1076,7 @@ class WebDriver extends Helper {
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {string} value text value to fill.
+   * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    * {{ react }}
    *
@@ -1785,7 +1785,7 @@ class WebDriver extends Helper {
    */
   async grabBrowserLogs() {
     if (this.browser.isW3C) {
-      this.debug('Logs not awailable in W3C specification');
+      this.debug('Logs not available in W3C specification');
       return;
     }
     return this.browser.getLogs('browser');

package/docs/changelog.md

@@ -7,6 +7,40 @@ layout: Section
 
 # Releases
 
+## 3.0.5
+
+
+Features:
+
+* **[Official Docker image for CodeceptJS v3](https://hub.docker.com/r/codeceptjs/codeceptjs)**. New Docker image is based on official Playwright image and supports Playwright, Puppeteer, WebDriver engines. Thanks **[VikentyShevyrin](https://github.com/VikentyShevyrin)**  
+* Better support for Typescript `codecept.conf.ts` configuration files. See [#2750](https://github.com/codeceptjs/CodeceptJS/issues/2750) by **[elaichenkov](https://github.com/elaichenkov)**
+* Propagate more events for custom parallel script. See [#2796](https://github.com/codeceptjs/CodeceptJS/issues/2796) by **[jccguimaraes](https://github.com/jccguimaraes)** 
+* [mocha-junit-reporter] Now supports attachments, see documentation for details. See [#2675](https://github.com/codeceptjs/CodeceptJS/issues/2675) by **[Shard](https://github.com/Shard)**
+* CustomLocators interface for TypeScript to extend from LocatorOrString. See [#2798](https://github.com/codeceptjs/CodeceptJS/issues/2798) by **[danielrentz](https://github.com/danielrentz)**
+* **[REST]** Mask sensitive data from log messages.
+```js
+I.sendPatchRequest('/api/users.json', secret({ "email": "user@user.com" }));
+```
+See [#2786](https://github.com/codeceptjs/CodeceptJS/issues/2786) by **[PeterNgTr](https://github.com/PeterNgTr)**
+
+Bug fixes:
+* Fixed reporting of nested steps with PageObjects and BDD scenarios. See [#2800](https://github.com/codeceptjs/CodeceptJS/issues/2800) by **[davertmik](https://github.com/davertmik)**. Fixes [#2720](https://github.com/codeceptjs/CodeceptJS/issues/2720) [#2682](https://github.com/codeceptjs/CodeceptJS/issues/2682)
+* Fixed issue with `codeceptjs shell` which was broken since 3.0.0. See [#2743](https://github.com/codeceptjs/CodeceptJS/issues/2743) by **[stedman](https://github.com/stedman)**
+* **[Gherkin]** Fixed issue suppressed or hidden errors in tests. See [#2745](https://github.com/codeceptjs/CodeceptJS/issues/2745) by **[ktryniszewski-mdsol](https://github.com/ktryniszewski-mdsol)**
+* **[Playwright]** fix grabCssPropertyFromAll serialization by using property names. See [#2757](https://github.com/codeceptjs/CodeceptJS/issues/2757) by **[elaichenkov](https://github.com/elaichenkov)**
+* **[Allure]** fix report for multi sessions. See [#2771](https://github.com/codeceptjs/CodeceptJS/issues/2771) by **[cbayer97](https://github.com/cbayer97)**
+* **[WebDriver]** Fix locator object debug log messages in smart wait. See 2748 by **[elaichenkov](https://github.com/elaichenkov)**
+
+Documentation fixes:
+* Fixed some broken examples. See [#2756](https://github.com/codeceptjs/CodeceptJS/issues/2756) by **[danielrentz](https://github.com/danielrentz)**
+* Fixed Typescript typings. See [#2747](https://github.com/codeceptjs/CodeceptJS/issues/2747), [#2758](https://github.com/codeceptjs/CodeceptJS/issues/2758) and [#2769](https://github.com/codeceptjs/CodeceptJS/issues/2769) by **[elaichenkov](https://github.com/elaichenkov)**
+* Added missing type for xFeature. See [#2754](https://github.com/codeceptjs/CodeceptJS/issues/2754) by **[PeterNgTr](https://github.com/PeterNgTr)**
+* Fixed code example in Page Object documentation. See [#2793](https://github.com/codeceptjs/CodeceptJS/issues/2793) by **[mkrtchian](https://github.com/mkrtchian)**
+
+Library updates:
+* Updated Axios to 0.21.1. See by **[sseide](https://github.com/sseide)**
+* Updated **[pollyjs](https://github.com/pollyjs)**/core **[pollyjs](https://github.com/pollyjs)**/adapter-puppeteer. See [#2760](https://github.com/codeceptjs/CodeceptJS/issues/2760) by **[Anikethana](https://github.com/Anikethana)**
+
 ## 3.0.4
 
 * **Hotfix** Fixed `init` script by adding `cross-spawn` package. By **[vipulgupta2048](https://github.com/vipulgupta2048)**

package/docs/data.md

@@ -154,8 +154,8 @@ Scenario('check post page', async ({ I })  => {
 // cleanup created data
 After(({ I }) => {
   I.sendMutation(
-    'mutation deletePost($permalink: /ID!) { deletePost(permalink: /$id) }',
-    { permalink: /postData.id},
+    'mutation deletePost($id: ID!) { deletePost(id: $id) }',
+    { id: postData.id},
   );
 });
 ```
@@ -196,7 +196,7 @@ The way for setting data for a test is as simple as writing:
 ```js
 // inside async function
 let post = await I.have('post');
-I.haveMultiple('comment', 5, { postpermalink: /post.id});
+I.haveMultiple('comment', 5, { postId: post.id});
 ```
 
 After completing the preparations under 'Data Generation with Factories', create a factory module which will export a factory.
@@ -248,7 +248,7 @@ This way for setting data for a test is as simple as writing:
 ```js
 // inside async function
 let post = await I.mutateData('createPost');
-I.mutateMultiple('createComment', 5, { postpermalink: /post.id});
+I.mutateMultiple('createComment', 5, { postId: post.id});
 ```
 
 
@@ -288,7 +288,7 @@ GraphQLDataFactory: {
       query: 'mutation createUser($input: UserInput!) { createUser(input: $input) { id name }}',
       factory: './factories/users',
       revert: (data) => ({
-        query: 'mutation deleteUser($permalink: /ID!) { deleteUser(permalink: /$id) }',
+        query: 'mutation deleteUser($id: ID!) { deleteUser(id: $id) }',
         variables: { id : data.id},
       }),
     },

package/docs/detox.md

@@ -179,7 +179,7 @@ If element differs on on iOS and Android you can use **cross platform locators**
 ```js
 // locate element by text on Android
 // locate element by accessibility id on iOS
-I.click({ android: /'Start', ios: '~start' });
+I.click({ android: 'Start', ios: '~start' });
 ```
 
 When application behavior differs on Android and iOS use platform-specific actions:
@@ -207,7 +207,7 @@ Scenario('save in application', ({ I }) => {
   I.fillField('#text', 'a new text');
   I.see('a new text', '#textValue');
   I.dontSeeElement('#createdAndVisibleText');
-  I.click({ ios: '#GoButton', android: /'Button' });
+  I.click({ ios: '#GoButton', android: 'Button' });
   I.waitForElement('#createdAndVisibleText', 20);
   I.seeElement('#createdAndVisibleText');
   I.runOnAndroid(() => {

package/docs/docker.md

@@ -1,6 +1,6 @@
 # Codeceptjs Docker
 
-CodeceptJS packed into container with the Nightmare, Protractor, Puppeteer, and WebDriver drivers.
+CodeceptJS has an [official docker image](https://hub.docker.com/r/codeceptjs/codeceptjs) based on Playwright image. Image supports Playwright, Puppeteer, and WebDriver engines.
 
 ## How to Use
 
@@ -16,17 +16,17 @@ CodeceptJS runner is available inside container as `codeceptjs`.
 You can execute CodeceptJS with Puppeteer or Nightmare locally with no extra configuration.
 
 ```sh
-docker run --net=host -v $PWD:/tests codeception/codeceptjs
+docker run --net=host -v $PWD:/tests codeceptjs/codeceptjs
 ```
 
 To customize execution call `codeceptjs` command:
 
 ```sh
 # run tests with steps
-docker run --net=host -v $PWD:/tests codeception/codeceptjs codeceptjs run --steps
+docker run --net=host -v $PWD:/tests codeceptjs/codeceptjs codeceptjs run --steps
 
 # run tests with @user in a name
-docker run --net=host -v $PWD:/tests codeception/codeceptjs codeceptjs run --grep "@user"
+docker run --net=host -v $PWD:/tests codeceptjs/codeceptjs codeceptjs run --grep "@user"
 ```
 
 
@@ -36,7 +36,7 @@ docker run --net=host -v $PWD:/tests codeception/codeceptjs codeceptjs run --gre
 version: '2'
 services:
   codeceptjs:
-    image: codeception/codeceptjs
+    image: codeceptjs/codeceptjs
     depends_on:
       - firefox
       - web
@@ -75,7 +75,7 @@ $ docker run -d -P --name selenium-chrome selenium/standalone-chrome
 
 # Alternatively, selenium/standalone-firefox can be used
 
-$ docker run -it --rm -v /<path_to_codeceptjs_test_dir>/:/tests/ --link selenium-chrome:selenium codeception/codeceptjs
+$ docker run -it --rm -v /<path_to_codeceptjs_test_dir>/:/tests/ --link selenium-chrome:selenium codeceptjs/codeceptjs
 ```
 
 You may run use `-v $(pwd)/:tests/` if running this from the root of your CodeceptJS tests directory.
@@ -87,7 +87,7 @@ _Note: If running with the Nightmare driver, it is not necessary to run a seleni
 To build this image:
 
 ```sh
-docker build -t codeception/codeceptjs .
+docker build -t codeceptjs/codeceptjs .
 ```
 
 * this directory will be added as `/codecept` insde container
@@ -97,7 +97,7 @@ docker build -t codeception/codeceptjs .
 To build this image with your desired Node version:
 
 ```sh
-docker build -t codeception/codeceptjs . --build-arg NODE_VERSION=12.10.0
+docker build -t codeceptjs/codeceptjs . --build-arg NODE_VERSION=12.10.0
 ```
 
 ### Passing Options
@@ -105,7 +105,7 @@ docker build -t codeception/codeceptjs . --build-arg NODE_VERSION=12.10.0
 Options can be passed by calling `codeceptjs`:
 
 ```
-docker run -v $PWD:/tests codeception/codeceptjs codeceptjs run --debug
+docker run -v $PWD:/tests codeceptjs/codeceptjs codeceptjs run --debug
 ```
 
 Alternatively arguments to `codecept run` command can be passed via `CODECEPT_ARGS` environment variable. For example to run your tests with debug
@@ -115,7 +115,7 @@ output:
 version: '2'
 services:
   codeceptjs:
-    image: codeception/codeceptjs
+    image: codeceptjs/codeceptjs
     environment:
       - CODECEPT_ARGS=--debug
     volumes:
@@ -128,7 +128,7 @@ You can also use `run-workers`to run tests by passing `NO_OF_WORKERS`, additiona
 version: '2'
 services:
   codeceptjs:
-    image: codeception/codeceptjs
+    image: codeceptjs/codeceptjs
     environment:
       - NO_OF_WORKERS=3
       - CODECEPT_ARGS=--debug

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