codeceptjs 3.3.3 → 3.3.4

package/CHANGELOG.md

@@ -1,3 +1,41 @@
+## 3.3.4
+
+* Added support for masking fields in objects via `secret` function:
+
+```js
+I.sendPostRequest('/auth', secret({ name: 'jon', password: '123456' }, 'password'));
+```
+* Added [a guide about using of `secret`](/secrets) function
+* [Appium] Use `touchClick` when interacting with elements in iOS. See #3317 by @mikk150
+* [Playwright] Added `cdpConnection` option to connect over CDP. See #3309 by @Hmihaly 
+* [customLocator plugin] Allowed to specify multiple attributes for custom locator. Thanks to @aruiz-caritsqa
+
+```js
+plugins: {
+ customLocator: {
+   enabled: true,
+   prefix: '$',
+   attribute: ['data-qa', 'data-test'],
+ }
+}
+```
+* [retryTo plugin] Fixed #3147 using `pollInterval` option. See #3351 by @cyonkee
+* [Playwright] Fixed grabbing of browser console messages and window resize in new tab. Thanks to @mirao
+* [REST] Added `prettyPrintJson` option to print JSON in nice way by @PeterNgTr 
+* [JSONResponse] Updated response validation to iterate over array items if response is array. Thanks to @PeterNgTr
+
+```js
+// response.data == [
+//   { user: { name: 'jon', email: 'jon@doe.com' } },
+//   { user: { name: 'matt', email: 'matt@doe.com' } },
+//]
+
+I.seeResponseContainsKeys(['user']);
+I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+I.seeResponseContainsJson({ user: { email: 'matt@doe.com' } });
+I.dontSeeResponseContainsJson({ user: 2 });
+```
+
 ## 3.3.3
 
 * Fixed `DataCloneError: () => could not be cloned` when running data tests in run-workers

package/docs/api.md

@@ -263,6 +263,8 @@ The most basic thing to check in response is existence of keys in JSON object. U
 I.seeResponseContainsKeys(['name', 'email']);
 ```
 
+> ℹ️ If response is an array, it will check that every element in array have provided keys
+
 However, this is a very naive approach. It won't work for arrays or nested objects.
 To check complex JSON structures `JSONResponse` helper uses [`joi`](https://joi.dev) library. 
 It has rich API to validate JSON by the schema defined using JavaScript. 
@@ -296,6 +298,8 @@ I.seeResponseContainsJson({
 })
 ```
 
+> ℹ️ If response is an array, it will check that at least one element in array matches JSON
+
 To perform arbitrary assertions on a response object use `seeResponseValidByCallback`. 
 It allows you to do any kind of assertions by using `expect` from [`chai`](https://www.chaijs.com) library.
 

package/docs/basics.md

@@ -212,6 +212,8 @@ To fill in sensitive data use the `secret` function, it won't expose actual valu
 I.fillField('password', secret('123456'));
 ```
 
+> ℹ️ Learn more about [masking secret](/secrets/) output
+
 ### Assertions
 
 In order to verify the expected behavior of a web application, its content should be checked.

package/docs/build/JSONResponse.js

@@ -1,3 +1,4 @@
+const assert = require('assert');
 const chai = require('chai');
 const joi = require('joi');
 const chaiDeepMatch = require('chai-deep-match');
@@ -173,12 +174,30 @@ class JSONResponse extends Helper {
    *
    * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
    * ```
+   * If an array is received, checks that at least one element contains JSON
+   * ```js
+   * // response.data == [{ user: { name: 'jon', email: 'jon@doe.com' } }]
+   *
+   * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+   * ```
    *
    * @param {object} json
    */
   seeResponseContainsJson(json = {}) {
     this._checkResponseReady();
-    expect(this.response.data).to.deep.match(json);
+    if (Array.isArray(this.response.data)) {
+      let fails = 0;
+      for (const el of this.response.data) {
+        try {
+          expect(el).to.deep.match(json);
+        } catch (err) {
+          fails++;
+        }
+      }
+      assert.ok(fails < this.response.data.length, `No elements in array matched ${JSON.stringify(json)}`);
+    } else {
+      expect(this.response.data).to.deep.match(json);
+    }
   }
 
   /**
@@ -189,12 +208,22 @@ class JSONResponse extends Helper {
    *
    * I.dontSeeResponseContainsJson({ user: 2 });
    * ```
+   * If an array is received, checks that no element of array contains json:
+   * ```js
+   * // response.data == [{ user: 1 }, { user: 3 }]
+   *
+   * I.dontSeeResponseContainsJson({ user: 2 });
+   * ```
    *
    * @param {object} json
    */
   dontSeeResponseContainsJson(json = {}) {
     this._checkResponseReady();
-    expect(this.response.data).not.to.deep.match(json);
+    if (Array.isArray(this.response.data)) {
+      this.response.data.forEach(data => expect(data).not.to.deep.match(json));
+    } else {
+      expect(this.response.data).not.to.deep.match(json);
+    }
   }
 
   /**
@@ -206,11 +235,23 @@ class JSONResponse extends Helper {
    * I.seeResponseContainsKeys(['user']);
    * ```
    *
+   * If an array is received, check is performed for each element of array:
+   *
+   * ```js
+   * // response.data == [{ user: 'jon' }, { user: 'matt'}]
+   *
+   * I.seeResponseContainsKeys(['user']);
+   * ```
+   *
    * @param {array} keys
    */
   seeResponseContainsKeys(keys = []) {
     this._checkResponseReady();
-    expect(this.response.data).to.include.keys(keys);
+    if (Array.isArray(this.response.data)) {
+      this.response.data.forEach(data => expect(data).to.include.keys(keys));
+    } else {
+      expect(this.response.data).to.include.keys(keys);
+    }
   }
 
   /**

package/docs/build/Playwright.js

@@ -167,7 +167,8 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  *      Playwright: {
  *        url: "http://localhost",
  *        chromium: {
- *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a'
+ *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a',
+ *          cdpConnection: false // default is false
  *        }
  *      }
  *    }
@@ -272,6 +273,7 @@ class Playwright extends Helper {
     this.sessionPages = {};
     this.activeSessionName = '';
     this.isElectron = false;
+    this.isCDPConnection = false;
     this.electronSessions = [];
     this.storageState = null;
 
@@ -347,6 +349,7 @@ class Playwright extends Helper {
     this.isRemoteBrowser = !!this.playwrightOptions.browserWSEndpoint;
     this.isElectron = this.options.browser === 'electron';
     this.userDataDir = this.playwrightOptions.userDataDir;
+    this.isCDPConnection = this.playwrightOptions.cdpConnection;
     popupStore.defaultAction = this.options.defaultPopupAction;
   }
 
@@ -699,6 +702,15 @@ class Playwright extends Helper {
   async _startBrowser() {
     if (this.isElectron) {
       this.browser = await playwright._electron.launch(this.playwrightOptions);
+    } else if (this.isRemoteBrowser && this.isCDPConnection) {
+      try {
+        this.browser = await playwright[this.options.browser].connectOverCDP(this.playwrightOptions);
+      } catch (err) {
+        if (err.toString().indexOf('ECONNREFUSED')) {
+          throw new RemoteBrowserConnectionRefused(err);
+        }
+        throw err;
+      }
     } else if (this.isRemoteBrowser) {
       try {
         this.browser = await playwright[this.options.browser].connect(this.playwrightOptions);
@@ -1157,6 +1169,7 @@ class Playwright extends Helper {
     if (!page) {
       throw new Error(`There is no ability to switch to next tab with offset ${num}`);
     }
+    targetCreatedHandler.call(this, page);
     await this._setPage(page);
     return this._waitForAction();
   }
@@ -1239,7 +1252,9 @@ class Playwright extends Helper {
     if (this.isElectron) {
       throw new Error('Cannot open new tabs inside an Electron container');
     }
-    await this._setPage(await this.browserContext.newPage(options));
+    const page = await this.browserContext.newPage(options);
+    targetCreatedHandler.call(this, page);
+    await this._setPage(page);
     return this._waitForAction();
   }
 
@@ -2071,9 +2086,11 @@ class Playwright extends Helper {
    * Get JS log from browser.
    *
    * ```js
-   * let logs = await I.grabBrowserLogs();
-   * console.log(JSON.stringify(logs))
+   * const logs = await I.grabBrowserLogs();
+   * const errors = logs.map(l => ({ type: l.type(), text: l.text() })).filter(l => l.type === 'error');
+   * console.log(JSON.stringify(errors));
    * ```
+   * [Learn more about console messages](https://playwright.dev/docs/api/class-consolemessage)
    * @return {Promise<any[]>}
    */
   async grabBrowserLogs() {

package/docs/build/REST.js

@@ -2,6 +2,7 @@ const axios = require('axios').default;
 const Secret = require('../secret');
 
 const Helper = require('../helper');
+const { beautify } = require('../utils');
 
 /**
  * REST helper allows to send additional requests to the REST API during acceptance tests.
@@ -10,6 +11,7 @@ const Helper = require('../helper');
  * ## Configuration
  *
  * * endpoint: API base URL
+ * * prettyPrintJson: pretty print json for response/request on console logs
  * * timeout: timeout for requests in milliseconds. 10000ms by default
  * * defaultHeaders: a list of default headers
  * * onRequest: a async function which can update request object.
@@ -22,6 +24,7 @@ const Helper = require('../helper');
  *   helpers: {
  *     REST: {
  *       endpoint: 'http://site.com/api',
+ *       prettyPrintJson: true,
  *       onRequest: (request) => {
  *       request.headers.auth = '123';
  *     }
@@ -49,6 +52,7 @@ class REST extends Helper {
       timeout: 10000,
       defaultHeaders: {},
       endpoint: '',
+      prettyPrintJson: false,
     };
 
     if (this.options.maxContentLength) {
@@ -137,7 +141,7 @@ class REST extends Helper {
       await this.config.onRequest(request);
     }
 
-    this.debugSection('Request', JSON.stringify(_debugRequest));
+    this.options.prettyPrintJson ? this.debugSection('Request', beautify(JSON.stringify(_debugRequest))) : this.debugSection('Request', JSON.stringify(_debugRequest));
 
     let response;
     try {
@@ -150,7 +154,7 @@ class REST extends Helper {
     if (this.config.onResponse) {
       await this.config.onResponse(response);
     }
-    this.debugSection('Response', JSON.stringify(response.data));
+    this.options.prettyPrintJson ? this.debugSection('Response', beautify(JSON.stringify(response.data))) : this.debugSection('Response', JSON.stringify(response.data));
     return response;
   }
 

package/docs/build/WebDriver.js

@@ -942,7 +942,7 @@ class WebDriver extends Helper {
    * {{ react }}
    */
   async click(locator, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findClickable.call(this, locator, locateFn);
@@ -1296,7 +1296,7 @@ class WebDriver extends Helper {
    * Appium: not tested
    */
   async checkOption(field, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findCheckable.call(this, field, locateFn);
@@ -1327,7 +1327,7 @@ class WebDriver extends Helper {
    * Appium: not tested
    */
   async uncheckOption(field, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findCheckable.call(this, field, locateFn);
@@ -2212,7 +2212,7 @@ class WebDriver extends Helper {
       assertElementExists(res);
       const elem = usingFirstElement(res);
       const elementId = getElementId(elem);
-      if (this.browser.isMobile) return this.browser.touchScroll(offsetX, offsetY, elementId);
+      if (this.browser.isMobile && this.browser.capabilities.platformName !== 'android') return this.browser.touchScroll(offsetX, offsetY, elementId);
       const location = await elem.getLocation();
       assertElementExists(location, 'Failed to receive', 'location');
       /* eslint-disable prefer-arrow-callback */
@@ -2220,7 +2220,7 @@ class WebDriver extends Helper {
       /* eslint-enable */
     }
 
-    if (this.browser.isMobile) return this.browser.touchScroll(locator, offsetX, offsetY);
+    if (this.browser.isMobile && this.browser.capabilities.platformName !== 'android') return this.browser.touchScroll(locator, offsetX, offsetY);
 
     /* eslint-disable prefer-arrow-callback, comma-dangle */
     return this.browser.execute(function (x, y) { return window.scrollTo(x, y); }, offsetX, offsetY);

package/docs/changelog.md

@@ -7,6 +7,44 @@ layout: Section
 
 # Releases
 
+## 3.3.4
+
+* Added support for masking fields in objects via `secret` function:
+
+```js
+I.sendPostRequest('/auth', secret({ name: 'jon', password: '123456' }, 'password'));
+```
+* Added [a guide about using of `secret`](/secrets) function
+* **[Appium]** Use `touchClick` when interacting with elements in iOS. See [#3317](https://github.com/codeceptjs/CodeceptJS/issues/3317) by **[mikk150](https://github.com/mikk150)**
+* **[Playwright]** Added `cdpConnection` option to connect over CDP. See [#3309](https://github.com/codeceptjs/CodeceptJS/issues/3309) by **[Hmihaly](https://github.com/Hmihaly)** 
+* [customLocator plugin] Allowed to specify multiple attributes for custom locator. Thanks to **[aruiz-caritsqa](https://github.com/aruiz-caritsqa)**
+
+```js
+plugins: {
+ customLocator: {
+   enabled: true,
+   prefix: '$',
+   attribute: ['data-qa', 'data-test'],
+ }
+}
+```
+* [retryTo plugin] Fixed [#3147](https://github.com/codeceptjs/CodeceptJS/issues/3147) using `pollInterval` option. See [#3351](https://github.com/codeceptjs/CodeceptJS/issues/3351) by **[cyonkee](https://github.com/cyonkee)**
+* **[Playwright]** Fixed grabbing of browser console messages and window resize in new tab. Thanks to **[mirao](https://github.com/mirao)**
+* **[REST]** Added `prettyPrintJson` option to print JSON in nice way by **[PeterNgTr](https://github.com/PeterNgTr)** 
+* **[JSONResponse]** Updated response validation to iterate over array items if response is array. Thanks to **[PeterNgTr](https://github.com/PeterNgTr)**
+
+```js
+// response.data == [
+//   { user: { name: 'jon', email: 'jon@doe.com' } },
+//   { user: { name: 'matt', email: 'matt@doe.com' } },
+//]
+
+I.seeResponseContainsKeys(['user']);
+I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+I.seeResponseContainsJson({ user: { email: 'matt@doe.com' } });
+I.dontSeeResponseContainsJson({ user: 2 });
+```
+
 ## 3.3.3
 
 * Fixed `DataCloneError: () => could not be cloned` when running data tests in run-workers

package/docs/helpers/JSONResponse.md

@@ -92,6 +92,14 @@ Checks for deep inclusion of a provided json in a response data.
 I.dontSeeResponseContainsJson({ user: 2 });
 ```
 
+If an array is received, checks that no element of array contains json:
+
+```js
+// response.data == [{ user: 1 }, { user: 3 }]
+
+I.dontSeeResponseContainsJson({ user: 2 });
+```
+
 #### Parameters
 
 -   `json` **[object][2]**  
@@ -139,6 +147,14 @@ Checks for deep inclusion of a provided json in a response data.
 I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
 ```
 
+If an array is received, checks that at least one element contains JSON
+
+```js
+// response.data == [{ user: { name: 'jon', email: 'jon@doe.com' } }]
+
+I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+```
+
 #### Parameters
 
 -   `json` **[object][2]**  
@@ -153,6 +169,14 @@ Checks for deep inclusion of a provided json in a response data.
 I.seeResponseContainsKeys(['user']);
 ```
 
+If an array is received, check is performed for each element of array:
+
+```js
+// response.data == [{ user: 'jon' }, { user: 'matt'}]
+
+I.seeResponseContainsKeys(['user']);
+```
+
 #### Parameters
 
 -   `keys` **[array][3]**  

package/docs/helpers/Playwright.md

@@ -131,7 +131,8 @@ Traces will be saved to `output/trace`
      Playwright: {
        url: "http://localhost",
        chromium: {
-         browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a'
+         browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a',
+         cdpConnection: false // default is false
        }
      }
    }
@@ -811,10 +812,13 @@ Returns **[Promise][18]<[Array][19]<[string][12]>>** attribute value
 Get JS log from browser.
 
 ```js
-let logs = await I.grabBrowserLogs();
-console.log(JSON.stringify(logs))
+const logs = await I.grabBrowserLogs();
+const errors = logs.map(l => ({ type: l.type(), text: l.text() })).filter(l => l.type === 'error');
+console.log(JSON.stringify(errors));
 ```
 
+[Learn more about console messages][20]
+
 Returns **[Promise][18]<[Array][19]<any>>** 
 
 ### grabCookie
@@ -1102,7 +1106,7 @@ Returns **[Promise][18]<[Array][19]<[string][12]>>** attribute value
 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][20] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][21] to check that file were downloaded correctly.
 
 ```js
 I.handleDownloads('downloads/avatar.jpg');
@@ -1133,7 +1137,7 @@ I.haveRequestHeaders({
 
 ### makeApiRequest
 
-Performs [api request][21] using
+Performs [api request][22] using
 the cookies from the current browser session.
 
 ```js
@@ -1154,17 +1158,17 @@ Returns **[Promise][18]<[object][10]>** response
 
 ### mockRoute
 
-Mocks network request using [`browserContext.route`][22] of Playwright
+Mocks network request using [`browserContext.route`][23] of Playwright
 
 ```js
 I.mockRoute(/(.png$)|(.jpg$)/, route => route.abort());
 ```
 
-This method allows intercepting and mocking requests & responses. [Learn more about it][23]
+This method allows intercepting and mocking requests & responses. [Learn more about it][24]
 
 #### Parameters
 
--   `url` **([string][12] | [RegExp][24])?** URL, regex or pattern for to match URL
+-   `url` **([string][12] | [RegExp][25])?** URL, regex or pattern for to match URL
 -   `handler` **[function][17]?** a function to process reques
 
 ### moveCursorTo
@@ -1192,7 +1196,7 @@ Open new tab and automatically switched to new tab
 I.openNewTab();
 ```
 
-You can pass in [page options][25] to emulate device on this page
+You can pass in [page options][26] to emulate device on this page
 
 ```js
 // enable mobile
@@ -1207,7 +1211,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`][26].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][27].
 
 ```js
 I.pressKey('Backspace');
@@ -1267,13 +1271,13 @@ Some of the supported key names are:
 #### Parameters
 
 -   `key` **([string][12] | [Array][19]<[string][12]>)** key or array of keys to press.
-    [!] returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][27]).
+    [!] returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][28]).
 
 ### 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`][28]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][29]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1290,7 +1294,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`][28]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][29]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1378,7 +1382,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 -   `fileName` **[string][12]** file name to save.
--   `fullPage` **[boolean][29]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
+-   `fullPage` **[boolean][30]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
     [!] returns a _promise_ which is synchronized internally by recorder 
 
 ### scrollPageToBottom
@@ -1724,7 +1728,7 @@ If no handler is passed, all mock requests for the rote are disabled.
 
 #### Parameters
 
--   `url` **([string][12] | [RegExp][24])?** URL, regex or pattern for to match URL
+-   `url` **([string][12] | [RegExp][25])?** URL, regex or pattern for to match URL
 -   `handler` **[function][17]?** a function to process reques
 
 ### switchTo
@@ -1771,7 +1775,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`][26] is not an option.
+_Note:_ Should be used when [`fillField`][27] is not an option.
 
 ```js
 // passing in a string
@@ -1808,7 +1812,7 @@ I.uncheckOption('agree', '//form');
 
 -   `field` **([string][12] | [object][10])** checkbox located by label | name | CSS | XPath | strict locator.
 -   `context` **([string][12]? | [object][10])** (optional, `null` by default) element located by CSS | XPath | strict locator.
-    [!] returns a _promise_ which is synchronized internally by recorder[Additional options][30] for uncheck available as 3rd argument.Examples:```js
+    [!] returns a _promise_ which is synchronized internally by recorder[Additional options][31] for uncheck available as 3rd argument.Examples:```js
     // click on element at position
     I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
     ```> ⚠️ To avoid flakiness, option `force: true` is set by default 
@@ -1821,7 +1825,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`][31], [`browserContext`][32] [`browser`][33] } objects from Playwright API are available.
+{ [`page`][32], [`browserContext`][33] [`browser`][34] } objects from Playwright API are available.
 
 ```js
 I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
@@ -1947,7 +1951,7 @@ I.waitForInvisible('#popup');
 
 Waits for navigation to finish. By default takes configured `waitForNavigation` option.
 
-See [Playwright's reference][34]
+See [Playwright's reference][35]
 
 #### Parameters
 
@@ -2027,7 +2031,7 @@ I.waitForVisible('#popup');
 
 -   `locator` **([string][12] | [object][10])** element located by CSS|XPath|strict locator.
 -   `sec` **[number][16]** (optional, `1` by default) time in seconds to wait
-    [!] returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][35]. 
+    [!] returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][36]. 
 
 ### waitInUrl
 
@@ -2126,34 +2130,36 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
 
 [19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[20]: https://codecept.io/helpers/FileSystem
+[20]: https://playwright.dev/docs/api/class-consolemessage
+
+[21]: https://codecept.io/helpers/FileSystem
 
-[21]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
+[22]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
 
-[22]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
+[23]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
 
-[23]: https://playwright.dev/docs/network#handle-requests
+[24]: https://playwright.dev/docs/network#handle-requests
 
-[24]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
 
-[25]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
+[26]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
 
-[26]: #fillfield
+[27]: #fillfield
 
-[27]: https://github.com/GoogleChrome/puppeteer/issues/1313
+[28]: https://github.com/GoogleChrome/puppeteer/issues/1313
 
-[28]: #click
+[29]: #click
 
-[29]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[30]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[30]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
+[31]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
 
-[31]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
+[32]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
 
-[32]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
+[33]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
 
-[33]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
+[34]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
 
-[34]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
+[35]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
 
-[35]: https://codecept.io/react
+[36]: https://codecept.io/react

package/docs/helpers/REST.md

@@ -17,6 +17,7 @@ REST helper allows to send additional requests to the REST API during acceptance
 ## Configuration
 
 -   endpoint: API base URL
+-   prettyPrintJson: pretty print json for response/request on console logs
 -   timeout: timeout for requests in milliseconds. 10000ms by default
 -   defaultHeaders: a list of default headers
 -   onRequest: a async function which can update request object.
@@ -29,6 +30,7 @@ REST helper allows to send additional requests to the REST API during acceptance
   helpers: {
     REST: {
       endpoint: 'http://site.com/api',
+      prettyPrintJson: true,
       onRequest: (request) => {
       request.headers.auth = '123';
     }

package/docs/plugins.md

@@ -512,6 +512,46 @@ I.seeElement('=user'); // matches => [data-qa=user]
 I.click('=sign-up'); // matches => [data-qa=sign-up]
 ```
 
+Using `data-qa` OR `data-test` attribute with `=` prefix:
+
+```js
+// in codecept.conf.js
+plugins: {
+ customLocator: {
+   enabled: true,
+   prefix: '=',
+   attribute: ['data-qa', 'data-test'],
+   strategy: 'xpath'
+ }
+}
+```
+
+In a test:
+
+```js
+I.seeElement('=user'); // matches => //*[@data-qa=user or @data-test=user]
+I.click('=sign-up'); // matches => //*[data-qa=sign-up or @data-test=sign-up]
+```
+
+```js
+// in codecept.conf.js
+plugins: {
+ customLocator: {
+   enabled: true,
+   prefix: '=',
+   attribute: ['data-qa', 'data-test'],
+   strategy: 'css'
+ }
+}
+```
+
+In a test:
+
+```js
+I.seeElement('=user'); // matches => [data-qa=user],[data-test=user]
+I.click('=sign-up'); // matches => [data-qa=sign-up],[data-test=sign-up]
+```
+
 ### Parameters
 
 -   `config`  
@@ -682,7 +722,7 @@ Run tests with plugin enabled:
 plugins: {
     retryFailedStep: {
         enabled: true,
-        ignoreSteps: [
+        ignoredSteps: [
           'scroll*', // ignore all scroll steps
           /Cookie/, // ignore all steps with a Cookie in it (by regexp)
         ]

package/docs/secrets.md

@@ -0,0 +1,30 @@
+# Secrets
+
+It is possible to mask out sensitive data when passing it to steps. This is important when filling password fields, or sending secure keys to API endpoint. 
+
+Wrap data in `secret` function to mask sensitive values in output and logs.
+
+For basic string `secret` just wrap a value into a string:
+
+```js
+I.fillField('password', secret('123456'));
+```
+
+When executed it will be printed like this:
+
+```
+I fill field "password" "*****"
+```
+
+For an object, which can be a payload to POST request, specify which fields should be masked:
+
+```js
+I.sendPostRequest('/login', secret({
+  name: 'davert',
+  password: '123456'
+}, 'password'))
+```
+
+The object created from `secret` is as Proxy to the object passed in. When printed password will be replaced with ****. 
+
+> ⚠️ Only direct properties of the object can be masked via `secret`

package/lib/command/interactive.js

@@ -21,7 +21,7 @@ module.exports = async function (path, options) {
 
     if (options.verbose) output.level(3);
 
-    output.print('String interactive shell for current suite...');
+    output.print('Starting interactive shell for current suite...');
     recorder.start();
     event.emit(event.suite.before, {
       fullTitle: () => 'Interactive Shell',

package/lib/helper/JSONResponse.js

@@ -1,3 +1,4 @@
+const assert = require('assert');
 const chai = require('chai');
 const joi = require('joi');
 const chaiDeepMatch = require('chai-deep-match');
@@ -173,12 +174,30 @@ class JSONResponse extends Helper {
    *
    * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
    * ```
+   * If an array is received, checks that at least one element contains JSON
+   * ```js
+   * // response.data == [{ user: { name: 'jon', email: 'jon@doe.com' } }]
+   *
+   * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+   * ```
    *
    * @param {object} json
    */
   seeResponseContainsJson(json = {}) {
     this._checkResponseReady();
-    expect(this.response.data).to.deep.match(json);
+    if (Array.isArray(this.response.data)) {
+      let fails = 0;
+      for (const el of this.response.data) {
+        try {
+          expect(el).to.deep.match(json);
+        } catch (err) {
+          fails++;
+        }
+      }
+      assert.ok(fails < this.response.data.length, `No elements in array matched ${JSON.stringify(json)}`);
+    } else {
+      expect(this.response.data).to.deep.match(json);
+    }
   }
 
   /**
@@ -189,12 +208,22 @@ class JSONResponse extends Helper {
    *
    * I.dontSeeResponseContainsJson({ user: 2 });
    * ```
+   * If an array is received, checks that no element of array contains json:
+   * ```js
+   * // response.data == [{ user: 1 }, { user: 3 }]
+   *
+   * I.dontSeeResponseContainsJson({ user: 2 });
+   * ```
    *
    * @param {object} json
    */
   dontSeeResponseContainsJson(json = {}) {
     this._checkResponseReady();
-    expect(this.response.data).not.to.deep.match(json);
+    if (Array.isArray(this.response.data)) {
+      this.response.data.forEach(data => expect(data).not.to.deep.match(json));
+    } else {
+      expect(this.response.data).not.to.deep.match(json);
+    }
   }
 
   /**
@@ -206,11 +235,23 @@ class JSONResponse extends Helper {
    * I.seeResponseContainsKeys(['user']);
    * ```
    *
+   * If an array is received, check is performed for each element of array:
+   *
+   * ```js
+   * // response.data == [{ user: 'jon' }, { user: 'matt'}]
+   *
+   * I.seeResponseContainsKeys(['user']);
+   * ```
+   *
    * @param {array} keys
    */
   seeResponseContainsKeys(keys = []) {
     this._checkResponseReady();
-    expect(this.response.data).to.include.keys(keys);
+    if (Array.isArray(this.response.data)) {
+      this.response.data.forEach(data => expect(data).to.include.keys(keys));
+    } else {
+      expect(this.response.data).to.include.keys(keys);
+    }
   }
 
   /**

package/lib/helper/Playwright.js

@@ -167,7 +167,8 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  *      Playwright: {
  *        url: "http://localhost",
  *        chromium: {
- *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a'
+ *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a',
+ *          cdpConnection: false // default is false
  *        }
  *      }
  *    }
@@ -272,6 +273,7 @@ class Playwright extends Helper {
     this.sessionPages = {};
     this.activeSessionName = '';
     this.isElectron = false;
+    this.isCDPConnection = false;
     this.electronSessions = [];
     this.storageState = null;
 
@@ -347,6 +349,7 @@ class Playwright extends Helper {
     this.isRemoteBrowser = !!this.playwrightOptions.browserWSEndpoint;
     this.isElectron = this.options.browser === 'electron';
     this.userDataDir = this.playwrightOptions.userDataDir;
+    this.isCDPConnection = this.playwrightOptions.cdpConnection;
     popupStore.defaultAction = this.options.defaultPopupAction;
   }
 
@@ -692,6 +695,15 @@ class Playwright extends Helper {
   async _startBrowser() {
     if (this.isElectron) {
       this.browser = await playwright._electron.launch(this.playwrightOptions);
+    } else if (this.isRemoteBrowser && this.isCDPConnection) {
+      try {
+        this.browser = await playwright[this.options.browser].connectOverCDP(this.playwrightOptions);
+      } catch (err) {
+        if (err.toString().indexOf('ECONNREFUSED')) {
+          throw new RemoteBrowserConnectionRefused(err);
+        }
+        throw err;
+      }
     } else if (this.isRemoteBrowser) {
       try {
         this.browser = await playwright[this.options.browser].connect(this.playwrightOptions);
@@ -1054,6 +1066,7 @@ class Playwright extends Helper {
     if (!page) {
       throw new Error(`There is no ability to switch to next tab with offset ${num}`);
     }
+    targetCreatedHandler.call(this, page);
     await this._setPage(page);
     return this._waitForAction();
   }
@@ -1136,7 +1149,9 @@ class Playwright extends Helper {
     if (this.isElectron) {
       throw new Error('Cannot open new tabs inside an Electron container');
     }
-    await this._setPage(await this.browserContext.newPage(options));
+    const page = await this.browserContext.newPage(options);
+    targetCreatedHandler.call(this, page);
+    await this._setPage(page);
     return this._waitForAction();
   }
 
@@ -1558,9 +1573,11 @@ class Playwright extends Helper {
    * Get JS log from browser.
    *
    * ```js
-   * let logs = await I.grabBrowserLogs();
-   * console.log(JSON.stringify(logs))
+   * const logs = await I.grabBrowserLogs();
+   * const errors = logs.map(l => ({ type: l.type(), text: l.text() })).filter(l => l.type === 'error');
+   * console.log(JSON.stringify(errors));
    * ```
+   * [Learn more about console messages](https://playwright.dev/docs/api/class-consolemessage)
    * @return {Promise<any[]>}
    */
   async grabBrowserLogs() {

package/lib/helper/REST.js

@@ -2,6 +2,7 @@ const axios = require('axios').default;
 const Secret = require('../secret');
 
 const Helper = require('../helper');
+const { beautify } = require('../utils');
 
 /**
  * REST helper allows to send additional requests to the REST API during acceptance tests.
@@ -10,6 +11,7 @@ const Helper = require('../helper');
  * ## Configuration
  *
  * * endpoint: API base URL
+ * * prettyPrintJson: pretty print json for response/request on console logs
  * * timeout: timeout for requests in milliseconds. 10000ms by default
  * * defaultHeaders: a list of default headers
  * * onRequest: a async function which can update request object.
@@ -22,6 +24,7 @@ const Helper = require('../helper');
  *   helpers: {
  *     REST: {
  *       endpoint: 'http://site.com/api',
+ *       prettyPrintJson: true,
  *       onRequest: (request) => {
  *       request.headers.auth = '123';
  *     }
@@ -49,6 +52,7 @@ class REST extends Helper {
       timeout: 10000,
       defaultHeaders: {},
       endpoint: '',
+      prettyPrintJson: false,
     };
 
     if (this.options.maxContentLength) {
@@ -137,7 +141,7 @@ class REST extends Helper {
       await this.config.onRequest(request);
     }
 
-    this.debugSection('Request', JSON.stringify(_debugRequest));
+    this.options.prettyPrintJson ? this.debugSection('Request', beautify(JSON.stringify(_debugRequest))) : this.debugSection('Request', JSON.stringify(_debugRequest));
 
     let response;
     try {
@@ -150,7 +154,7 @@ class REST extends Helper {
     if (this.config.onResponse) {
       await this.config.onResponse(response);
     }
-    this.debugSection('Response', JSON.stringify(response.data));
+    this.options.prettyPrintJson ? this.debugSection('Response', beautify(JSON.stringify(response.data))) : this.debugSection('Response', JSON.stringify(response.data));
     return response;
   }
 

package/lib/helper/WebDriver.js

@@ -907,7 +907,7 @@ class WebDriver extends Helper {
    * {{ react }}
    */
   async click(locator, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findClickable.call(this, locator, locateFn);
@@ -1117,7 +1117,7 @@ class WebDriver extends Helper {
    * Appium: not tested
    */
   async checkOption(field, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findCheckable.call(this, field, locateFn);
@@ -1136,7 +1136,7 @@ class WebDriver extends Helper {
    * Appium: not tested
    */
   async uncheckOption(field, context = null) {
-    const clickMethod = this.browser.isMobile ? 'touchClick' : 'elementClick';
+    const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick';
     const locateFn = prepareLocateFn.call(this, context);
 
     const res = await findCheckable.call(this, field, locateFn);
@@ -1623,7 +1623,7 @@ class WebDriver extends Helper {
       assertElementExists(res);
       const elem = usingFirstElement(res);
       const elementId = getElementId(elem);
-      if (this.browser.isMobile) return this.browser.touchScroll(offsetX, offsetY, elementId);
+      if (this.browser.isMobile && this.browser.capabilities.platformName !== 'android') return this.browser.touchScroll(offsetX, offsetY, elementId);
       const location = await elem.getLocation();
       assertElementExists(location, 'Failed to receive', 'location');
       /* eslint-disable prefer-arrow-callback */
@@ -1631,7 +1631,7 @@ class WebDriver extends Helper {
       /* eslint-enable */
     }
 
-    if (this.browser.isMobile) return this.browser.touchScroll(locator, offsetX, offsetY);
+    if (this.browser.isMobile && this.browser.capabilities.platformName !== 'android') return this.browser.touchScroll(locator, offsetX, offsetY);
 
     /* eslint-disable prefer-arrow-callback, comma-dangle */
     return this.browser.execute(function (x, y) { return window.scrollTo(x, y); }, offsetX, offsetY);

package/lib/plugin/customLocator.js

@@ -70,23 +70,70 @@ const defaultConfig = {
  * I.seeElement('=user'); // matches => [data-qa=user]
  * I.click('=sign-up'); // matches => [data-qa=sign-up]
  * ```
+ *
+ * Using `data-qa` OR `data-test` attribute with `=` prefix:
+ *
+ * ```js
+ * // in codecept.conf.js
+ * plugins: {
+ *  customLocator: {
+ *    enabled: true,
+ *    prefix: '=',
+ *    attribute: ['data-qa', 'data-test'],
+ *    strategy: 'xpath'
+ *  }
+ * }
+ * ```
+ *
+ * In a test:
+ *
+ * ```js
+ * I.seeElement('=user'); // matches => //*[@data-qa=user or @data-test=user]
+ * I.click('=sign-up'); // matches => //*[data-qa=sign-up or @data-test=sign-up]
+ * ```
+ *
+ * ```js
+ * // in codecept.conf.js
+ * plugins: {
+ *  customLocator: {
+ *    enabled: true,
+ *    prefix: '=',
+ *    attribute: ['data-qa', 'data-test'],
+ *    strategy: 'css'
+ *  }
+ * }
+ * ```
+ *
+ * In a test:
+ *
+ * ```js
+ * I.seeElement('=user'); // matches => [data-qa=user],[data-test=user]
+ * I.click('=sign-up'); // matches => [data-qa=sign-up],[data-test=sign-up]
+ * ```
  */
 module.exports = (config) => {
-  config = Object.assign(defaultConfig, config);
+  config = { ...defaultConfig, ...config };
 
   Locator.addFilter((value, locatorObj) => {
     if (typeof value !== 'string') return;
     if (!value.startsWith(config.prefix)) return;
 
+    if (!['String', 'Array'].includes(config.attribute.constructor.name)) return;
+
     const val = value.substr(config.prefix.length);
 
     if (config.strategy.toLowerCase() === 'xpath') {
-      locatorObj.value = `.//*[@${config.attribute}=${xpathLocator.literal(val)}]`;
+      locatorObj.value = `.//*[${
+        [].concat(config.attribute)
+          .map((attr) => `@${attr}=${xpathLocator.literal(val)}`)
+          .join(' or ')}]`;
       locatorObj.type = 'xpath';
     }
 
     if (config.strategy.toLowerCase() === 'css') {
-      locatorObj.value = `[${config.attribute}=${val}]`;
+      locatorObj.value = [].concat(config.attribute)
+        .map((attr) => `[${attr}=${val}]`)
+        .join(',');
       locatorObj.type = 'css';
     }
 

package/lib/plugin/retryFailedStep.js

@@ -60,7 +60,7 @@ const defaultConfig = {
  * plugins: {
  *     retryFailedStep: {
  *         enabled: true,
- *         ignoreSteps: [
+ *         ignoredSteps: [
  *           'scroll*', // ignore all scroll steps
  *           /Cookie/, // ignore all steps with a Cookie in it (by regexp)
  *         ]

package/lib/plugin/retryTo.js

@@ -101,27 +101,20 @@ module.exports = function (config) {
           err = e;
           recorder.session.restore(`retryTo ${tries}`);
           tries++;
-          // recorder.session.restore(`retryTo`);
           if (tries <= maxTries) {
             debug(`Error ${err}... Retrying`);
             err = null;
 
-            recorder.add(`retryTo ${tries}`, () => {
-              tryBlock();
-              // recorder.add(() => new Promise(done => setTimeout(done, pollInterval)));
-            });
+            recorder.add(`retryTo ${tries}`, () => setTimeout(tryBlock, pollInterval));
           } else {
-            // recorder.throw(err);
             done(null);
           }
         });
-        // return recorder.promise();
       };
 
       recorder.add('retryTo', async () => {
         store.debugMode = true;
         tryBlock();
-        // recorder.add(() => recorder.session.restore(`retryTo ${tries-1}`));
       });
     }).then(() => {
       if (err) recorder.throw(err);

package/lib/secret.js

@@ -1,3 +1,6 @@
+/* eslint-disable max-classes-per-file */
+const { deepClone } = require('./utils');
+
 /** @param {string} secret */
 class Secret {
   constructor(secret) {
@@ -9,13 +12,40 @@ class Secret {
     return this._secret;
   }
 
+  getMasked() {
+    return '*****';
+  }
+
   /**
    * @param {*} secret
    * @returns {Secret}
    */
   static secret(secret) {
+    if (typeof secret === 'object') {
+      const fields = Array.from(arguments);
+      fields.shift();
+      return secretObject(secret, fields);
+    }
     return new Secret(secret);
   }
 }
 
+function secretObject(obj, fieldsToHide = []) {
+  const handler = {
+    get(obj, prop) {
+      if (prop === 'toString') {
+        return function () {
+          const maskedObject = deepClone(obj);
+          fieldsToHide.forEach(f => maskedObject[f] = '****');
+          return JSON.stringify(maskedObject);
+        };
+      }
+
+      return obj[prop];
+    },
+  };
+
+  return new Proxy(obj, handler);
+}
+
 module.exports = Secret;

package/lib/step.js

@@ -168,7 +168,7 @@ class Step {
       } else if (typeof arg === 'undefined') {
         return `${arg}`;
       } else if (arg instanceof Secret) {
-        return '*****';
+        return arg.getMasked();
       } else if (arg.toString && arg.toString() !== '[object Object]') {
         return arg.toString();
       } else if (typeof arg === 'object') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.3.3",
+  "version": "3.3.4",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -90,7 +90,7 @@
     "uuid": "^8.3.2"
   },
   "devDependencies": {
-    "@codeceptjs/detox-helper": "^1.0.2",
+    "@codeceptjs/detox-helper": "^1.0.2",    
     "@codeceptjs/mock-request": "^0.3.1",
     "@faker-js/faker": "^5.5.3",
     "@pollyjs/adapter-puppeteer": "^5.1.0",
@@ -101,7 +101,7 @@
     "@wdio/selenium-standalone-service": "^5.16.10",
     "@wdio/utils": "^5.23.0",
     "apollo-server-express": "^2.25.3",
-    "chai-as-promised": "^5.2.0",
+    "chai-as-promised": "^7.1.1",
     "chai-subset": "^1.6.0",
     "contributor-faces": "^1.0.3",
     "documentation": "^12.3.0",
@@ -122,7 +122,7 @@
     "mocha-parallel-tests": "^2.3.0",
     "nightmare": "^3.0.2",
     "nodemon": "^1.19.4",
-    "playwright": "^1.18.1",
+    "playwright": "^1.23.2",
     "puppeteer": "^10.4.0",
     "qrcode-terminal": "^0.12.0",
     "rosie": "^1.6.0",

package/typings/types.d.ts

@@ -1562,6 +1562,12 @@ declare namespace CodeceptJS {
          *
          * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
          * ```
+         * If an array is received, checks that at least one element contains JSON
+         * ```js
+         * // response.data == [{ user: { name: 'jon', email: 'jon@doe.com' } }]
+         *
+         * I.seeResponseContainsJson({ user: { email: 'jon@doe.com' } });
+         * ```
          */
         seeResponseContainsJson(json: any): void;
         /**
@@ -1572,6 +1578,12 @@ declare namespace CodeceptJS {
          *
          * I.dontSeeResponseContainsJson({ user: 2 });
          * ```
+         * If an array is received, checks that no element of array contains json:
+         * ```js
+         * // response.data == [{ user: 1 }, { user: 3 }]
+         *
+         * I.dontSeeResponseContainsJson({ user: 2 });
+         * ```
          */
         dontSeeResponseContainsJson(json: any): void;
         /**
@@ -1582,6 +1594,14 @@ declare namespace CodeceptJS {
          *
          * I.seeResponseContainsKeys(['user']);
          * ```
+         *
+         * If an array is received, check is performed for each element of array:
+         *
+         * ```js
+         * // response.data == [{ user: 'jon' }, { user: 'matt'}]
+         *
+         * I.seeResponseContainsKeys(['user']);
+         * ```
          */
         seeResponseContainsKeys(keys: any[]): void;
         /**
@@ -2755,7 +2775,8 @@ declare namespace CodeceptJS {
      *      Playwright: {
      *        url: "http://localhost",
      *        chromium: {
-     *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a'
+     *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a',
+     *          cdpConnection: false // default is false
      *        }
      *      }
      *    }
@@ -3753,9 +3774,11 @@ declare namespace CodeceptJS {
          * Get JS log from browser.
          *
          * ```js
-         * let logs = await I.grabBrowserLogs();
-         * console.log(JSON.stringify(logs))
+         * const logs = await I.grabBrowserLogs();
+         * const errors = logs.map(l => ({ type: l.type(), text: l.text() })).filter(l => l.type === 'error');
+         * console.log(JSON.stringify(errors));
          * ```
+         * [Learn more about console messages](https://playwright.dev/docs/api/class-consolemessage)
          */
         grabBrowserLogs(): Promise<any[]>;
         /**
@@ -7436,6 +7459,7 @@ declare namespace CodeceptJS {
      * ## Configuration
      *
      * * endpoint: API base URL
+     * * prettyPrintJson: pretty print json for response/request on console logs
      * * timeout: timeout for requests in milliseconds. 10000ms by default
      * * defaultHeaders: a list of default headers
      * * onRequest: a async function which can update request object.
@@ -7448,6 +7472,7 @@ declare namespace CodeceptJS {
      *   helpers: {
      *     REST: {
      *       endpoint: 'http://site.com/api',
+     *       prettyPrintJson: true,
      *       onRequest: (request) => {
      *       request.headers.auth = '123';
      *     }