codeceptjs 3.5.4 → 3.5.6

package/docs/changelog.md

@@ -7,180 +7,11 @@ layout: Section
 
 # Releases
 
-## 3.5.4
-
-🐛 Bug Fixes:
- * **[Playwright]** When passing `userDataDir`, it throws error after test execution ([#3814](https://github.com/codeceptjs/CodeceptJS/issues/3814)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
- * [CodeceptJS-CLI] Improve command to generate types ([#3788](https://github.com/codeceptjs/CodeceptJS/issues/3788)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
- * Heal plugin fix ([#3820](https://github.com/codeceptjs/CodeceptJS/issues/3820)) - by **[davert](https://github.com/davert)**
- * Fix for error in using `all` with `run-workers` ([#3805](https://github.com/codeceptjs/CodeceptJS/issues/3805)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-```js
-  helpers: {
-    Playwright: {
-      url: 'https://github.com',
-      show: false,
-      browser: 'chromium',
-      waitForNavigation: 'load',
-      waitForTimeout: 30_000,
-      trace: true,
-      keepTraceForPassedTests: true
-    },
-  },
-  multiple: {
-    profile1: {
-      browsers: [
-        {
-          browser: "chromium",
-        }
-      ]
-    },
-  },
-```
- * Highlight elements issues ([#3779](https://github.com/codeceptjs/CodeceptJS/issues/3779)) ([#3778](https://github.com/codeceptjs/CodeceptJS/issues/3778)) - by **[philkas](https://github.com/philkas)**
- * Support `&nbsp` symbol in `I.see` method ([#3815](https://github.com/codeceptjs/CodeceptJS/issues/3815)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-
-```js
-// HTML code uses   instead of space
-<div class="dJHe_" style="color: rgb(255, 255, 255);">My&nbsp;Text!</div>
-
-I.see("My Text!") // this test would work with both &nbsp; and space
-```
-
-📖 Documentation
- * Improve the configuration of electron testing when the app is build with electron-forge ([#3802](https://github.com/codeceptjs/CodeceptJS/issues/3802)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-
-```js
-const path = require("path");
-
-exports.config = {
-  helpers: {
-    Playwright: {
-      browser: "electron",
-      electron: {
-        executablePath: require("electron"),
-        args: [path.join(__dirname, ".webpack/main/index.js")],
-      },
-    },
-  },
-  // rest of config
-}
-```
-
-🛩️ Features
-
-#### **[Playwright]** new features and improvements
- * Parse the response in recording network steps ([#3771](https://github.com/codeceptjs/CodeceptJS/issues/3771)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-
-```js
-      const traffics = await I.grabRecordedNetworkTraffics();
-      expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
-      expect(traffics[0].response.status).to.equal(200);
-      expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
-
-      expect(traffics[1].url).to.equal('https://reqres.in/api/comments/1');
-      expect(traffics[1].response.status).to.equal(200);
-      expect(traffics[1].response.body).to.contain({ name: 'this was another mocked' });
-```
- * Grab metrics ([#3809](https://github.com/codeceptjs/CodeceptJS/issues/3809)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-
-```js
-const metrics = await I.grabMetrics();
-
-// returned metrics
-
-[
-  { name: 'Timestamp', value: 1584904.203473 },
-  { name: 'AudioHandlers', value: 0 },
-  { name: 'AudioWorkletProcessors', value: 0 },
-  { name: 'Documents', value: 22 },
-  { name: 'Frames', value: 10 },
-  { name: 'JSEventListeners', value: 366 },
-  { name: 'LayoutObjects', value: 1240 },
-  { name: 'MediaKeySessions', value: 0 },
-  { name: 'MediaKeys', value: 0 },
-  { name: 'Nodes', value: 4505 },
-  { name: 'Resources', value: 141 },
-  { name: 'ContextLifecycleStateObservers', value: 34 },
-  { name: 'V8PerContextDatas', value: 4 },
-  { name: 'WorkerGlobalScopes', value: 0 },
-  { name: 'UACSSResources', value: 0 },
-  { name: 'RTCPeerConnections', value: 0 },
-  { name: 'ResourceFetchers', value: 22 },
-  { name: 'AdSubframes', value: 0 },
-  { name: 'DetachedScriptStates', value: 2 },
-  { name: 'ArrayBufferContents', value: 1 },
-  { name: 'LayoutCount', value: 0 },
-  { name: 'RecalcStyleCount', value: 0 },
-  { name: 'LayoutDuration', value: 0 },
-  { name: 'RecalcStyleDuration', value: 0 },
-  { name: 'DevToolsCommandDuration', value: 0.000013 },
-  { name: 'ScriptDuration', value: 0 },
-  { name: 'V8CompileDuration', value: 0 },
-  { name: 'TaskDuration', value: 0.000014 },
-  { name: 'TaskOtherDuration', value: 0.000001 },
-  { name: 'ThreadTime', value: 0.000046 },
-  { name: 'ProcessTime', value: 0.616852 },
-  { name: 'JSHeapUsedSize', value: 19004908 },
-  { name: 'JSHeapTotalSize', value: 26820608 },
-  { name: 'FirstMeaningfulPaint', value: 0 },
-  { name: 'DomContentLoaded', value: 1584903.690491 },
-  { name: 'NavigationStart', value: 1584902.841845 }
-]
-```
-
-* Grab WebSocket (WS) messages ([#3789](https://github.com/codeceptjs/CodeceptJS/issues/3789)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-  * `flushWebSocketMessages`
-  * `grabWebSocketMessages`
-  * `startRecordingWebSocketMessages`
-  * `stopRecordingWebSocketMessages`
-
-```js
-await I.startRecordingWebSocketMessages();
-I.amOnPage('https://websocketstest.com/');
-I.waitForText('Work for You!');
-I.flushNetworkTraffics();
-const wsMessages = I.grabWebSocketMessages();
-expect(wsMessages.length).to.equal(0);
-```
-
-```js
-await I.startRecordingWebSocketMessages();
-await I.amOnPage('https://websocketstest.com/');
-I.waitForText('Work for You!');
-const wsMessages = I.grabWebSocketMessages();
-expect(wsMessages.length).to.greaterThan(0);
-```
-
-```js
-await I.startRecordingWebSocketMessages();
-await I.amOnPage('https://websocketstest.com/');
-I.waitForText('Work for You!');
-const wsMessages = I.grabWebSocketMessages();
-await I.stopRecordingWebSocketMessages();
-await I.amOnPage('https://websocketstest.com/');
-I.waitForText('Work for You!');
-const afterWsMessages = I.grabWebSocketMessages();
-expect(wsMessages.length).to.equal(afterWsMessages.length);
-```
-
-* Move from `ElementHandle` to `Locator`. This change is quite major, but it happened under hood, so should not affect your code.  ([#3738](https://github.com/codeceptjs/CodeceptJS/issues/3738)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
-
 ## 3.5.3
 
 🛩️ Features
 
-* **[Playwright]** Added commands to check network traffic [#3748](https://github.com/codeceptjs/CodeceptJS/issues/3748) - by **[ngraf](https://github.com/ngraf)** **[KobeNguyenT](https://github.com/KobeNguyenT)**
-  * `startRecordingTraffic`
-  * `grabRecordedNetworkTraffics`
-  * `blockTraffic`
-  * `mockTraffic`
-  * `flushNetworkTraffics`
-  * `stopRecordingTraffic`
-  * `seeTraffic`
-  * `grabTrafficUrl`
-  * `dontSeeTraffic`
-
-Examples:
+* **[Playwright]** Provide new steps to check network traffic [#3748](https://github.com/codeceptjs/CodeceptJS/issues/3748) - by **[ngraf](https://github.com/ngraf)** **[KobeNguyenT](https://github.com/KobeNguyenT)**
 
 ```js
 // recording traffics and verify the traffic

package/docs/community-helpers.md

@@ -31,6 +31,9 @@ Please **add your own** by editing this page.
 * [codeceptjs-bshelper](https://github.com/PeterNgTr/codeceptjs-bshelper) - a helper which updates `Test Names` & `Test Results` on Browserstack 
 * [codeceptjs-tbhelper](https://github.com/testingbot/codeceptjs-tbhelper) - a helper which updates `Test Names` & `Test Results` on TestingBot 
 
+## Integrations
+* [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
+
 ## Visual-Testing
 * [codeceptjs-resemblehelper](https://github.com/puneet0191/codeceptjs-resemblehelper) - a helper which helps with visual testing using resemble.js. 
 * [codeceptjs-applitoolshelper](https://www.npmjs.com/package/codeceptjs-applitoolshelper) - a helper which helps interaction with [Applitools](https://applitools.com)
@@ -39,10 +42,8 @@ Please **add your own** by editing this page.
 ## Reporters
 * [codeceptjs-rphelper](https://github.com/reportportal/agent-js-codecept) is a CodeceptJS helper which can publish tests results on ReportPortal after execution.
 * [codeceptjs-xray-helper](https://www.npmjs.com/package/codeceptjs-xray-helper) is a CodeceptJS helper which can publish tests results on [XRAY](https://confluence.xpand-it.com/display/XRAYCLOUD/Import+Execution+Results+-+REST).
-* [codeceptjs-xray-cloud-helper](https://www.npmjs.com/package/codeceptjs-xray-cloud-helper) is a helper that automatically retrieves the result of CodeceptJS tests and sends them to XRAY/JIRA(cloud version) via [XRAY Cloud API](https://docs.getxray.app/display/XRAYCLOUD/Import+Execution+Results+-+REST+v2#ImportExecutionResultsRESTv2-XrayJSONresults).
 * [codeceptjs-slack-reporter](https://www.npmjs.com/package/codeceptjs-slack-reporter) Get a Slack notification when one or more scenarios fail.
 * [codeceptjs-browserlogs-plugin](https://github.com/pavkam/codeceptjs-browserlogs-plugin) Record the browser logs for failed tests.
-* [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
 
 ## Browser request control
 * [codeceptjs-resources-check](https://github.com/luarmr/codeceptjs-resources-check) Load a URL with Puppeteer and listen to the requests while the page is loading. Enabling count the number or check the sizes of the requests.
@@ -54,9 +55,4 @@ Please **add your own** by editing this page.
 ## Other
 
 * [codeceptjs-cmdhelper](https://github.com/thiagodp/codeceptjs-cmdhelper) allows you to run commands in the terminal/console
-* [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.
-* [codeceptjs-datalayer-helper](https://github.com/kobenguyent/codeceptjs-datalayer-helper) CodeceptJS DataLayer helper helps you to get the datalayer JavaScript array that is used to store information and send this data to the tag manager.
-* [codeceptjs-a11y-helper](https://github.com/kobenguyent/codeceptjs-a11y-helper) accessibility tests integrated with CodeceptJS - Playwright-axe
-* [codeceptjs-lighthouse-helper](https://github.com/kobenguyent/codeceptjs-lighthouse-helper) lighthouse audit integrated with CodeceptJS - Playwright
-* [Snowplow Data analytics](https://www.npmjs.com/package/@viasat/codeceptjs-snowplow-helper) - Test your Snowplow events implementations with CodeceptJS and Snowplow Micro.
-* [codeceptjs-failure-logger](https://github.com/kobenguyent/codeceptjs-failure-logger) - Log failed CodeceptJS tests to file
+* [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.

package/docs/examples.md

@@ -16,7 +16,6 @@ Playground repository where you can run tests in different helpers on a basic si
 
 Tests repository demonstrate usage of
 
-* Playwright helper
 * Puppeteer helper
 * WebDriver helper
 * TestCafe plugin
@@ -29,6 +28,7 @@ Tests repository demonstrate usage of
 CodeceptJS repo contains basic tests (both failing and passing) just to show how it works.
 Our team uses it to test new features and run simple scenarios.
 
+
 ## [CodeceptJS Cucumber E2E Framework](https://github.com/gkushang/codeceptjs-e2e)
 
 This repository contains complete E2E framework for CodeceptJS with Cucumber and SauceLabs Integration
@@ -146,10 +146,4 @@ This is necessary if all integrations with TMS and CI/CD are already configured,
 * HTTP request client with session support and unit tests
 * Exemplary code control
 * Ready to launch in a CI/CD system as is
-* OOP, Test data models and builders, endpoint decorators
-
-## [Playwright fun with CodeceptJS](https://github.com/PeterNgTr/codeceptjs-playwright-fun)
-* Tests are written in TS
-* CI/CD with Github Actions
-* Page Object Model is applied
-* ReportPortal Integration
+* OOP, Test data models and builders, endpoint decorators

package/docs/helpers/Appium.md

@@ -99,6 +99,43 @@ helpers: {
 }
 ```
 
+Example Android App using Appiumv2 on BrowserStack:
+
+```js
+{
+helpers: {
+  Appium: {
+        appiumV2: true,
+        host: "hub-cloud.browserstack.com",
+        port: 4444,
+        user: process.env.BROWSERSTACK_USER,
+        key: process.env.BROWSERSTACK_KEY,
+        app: `bs://c700ce60cf1gjhgjh3ae8ed9770ghjg5a55b8e022f13c5827cg`,
+        browser: '',
+        desiredCapabilities: {
+            'appPackage': data.packageName,
+            'deviceName': process.env.DEVICE || 'Google Pixel 3',
+            'platformName': process.env.PLATFORM || 'android',
+            'platformVersion': process.env.OS_VERSION || '10.0',
+            'automationName': process.env.ENGINE || 'UIAutomator2',
+            'newCommandTimeout': 300000,
+            'androidDeviceReadyTimeout': 300000,
+            'androidInstallTimeout': 90000,
+            'appWaitDuration': 300000,
+            'autoGrantPermissions': true,
+            'gpsEnabled': true,
+            'isHeadless': false,
+            'noReset': false,
+            'noSign': true,
+            'bstack:options' : {
+                "appiumVersion" : "2.0.1",
+            },
+        }
+  }
+}
+}
+```
+
 Additional configuration params can be used from [https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md][4]
 
 ## Access From Helpers

package/docs/helpers/FileSystem.md

@@ -140,7 +140,7 @@ I.waitForFile('largeFilesName.txt', 10); // wait 10 seconds for file
 
 ### writeToFile
 
-Writes test to file
+Writes text to file
 
 #### Parameters
 

package/docs/helpers/Nightmare.md

@@ -379,9 +379,10 @@ let val = await I.executeAsyncScript(function(url, done) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderWrapper for asynchronous [evaluate][7].
-    Unlike NightmareJS implementation calling `done` will return its first argument.
--   `fn` **([string][3] | [function][8])** function to be executed in browser context.
+-   `fn` **([string][3] | [function][7])** function to be executed in browser context.
+
+Returns **[Promise][8]<any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorderWrapper for asynchronous [evaluate][9].
+Unlike NightmareJS implementation calling `done` will return its first argument.
 
 ### executeScript
 
@@ -412,8 +413,9 @@ let date = await I.executeScript(function(el) {
 #### Parameters
 
 -   `args` **...any** to be passed to function.
-    ⚠️ returns a _promise_ which is synchronized internally by recorderWrapper for synchronous [evaluate][7]
--   `fn` **([string][3] | [function][8])** function to be executed in browser context.
+-   `fn` **([string][3] | [function][7])** function to be executed in browser context.
+
+Returns **[Promise][8]<any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorderWrapper for synchronous [evaluate][9]
 
 ### fillField
 
@@ -452,7 +454,7 @@ let hint = await I.grabAttributeFrom('#tooltip', 'title');
 -   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][3]** attribute name.
 
-Returns **[Promise][9]<[string][3]>** attribute value
+Returns **[Promise][8]<[string][3]>** attribute value
 
 ### grabAttributeFromAll
 
@@ -468,7 +470,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 -   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 -   `attr` **[string][3]** attribute name.
 
-Returns **[Promise][9]<[Array][10]<[string][3]>>** attribute value
+Returns **[Promise][8]<[Array][10]<[string][3]>>** attribute value
 
 ### grabCookie
 
@@ -485,7 +487,7 @@ assert(cookie.value, '123456');
 
 -   `name` **[string][3]?** cookie name. 
 
-Returns **([Promise][9]<[string][3]> | [Promise][9]<[Array][10]<[string][3]>>)** attribute valueCookie in JSON format. If name not passed returns all cookies for this domain.Multiple cookies can be received by passing query object `I.grabCookie({ secure: true});`. If you'd like get all cookies for all urls, use: `.grabCookie({ url: null }).`
+Returns **([Promise][8]<[string][3]> | [Promise][8]<[Array][10]<[string][3]>>)** attribute valueCookie in JSON format. If name not passed returns all cookies for this domain.Multiple cookies can be received by passing query object `I.grabCookie({ secure: true});`. If you'd like get all cookies for all urls, use: `.grabCookie({ url: null }).`
 
 ### grabCssPropertyFrom
 
@@ -502,7 +504,7 @@ const value = await I.grabCssPropertyFrom('h3', 'font-weight');
 -   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 -   `cssProperty` **[string][3]** CSS property name.
 
-Returns **[Promise][9]<[string][3]>** CSS value
+Returns **[Promise][8]<[string][3]>** CSS value
 
 ### grabCurrentUrl
 
@@ -514,7 +516,7 @@ let url = await I.grabCurrentUrl();
 console.log(`Current URL is [${url}]`);
 ```
 
-Returns **[Promise][9]<[string][3]>** current URL
+Returns **[Promise][8]<[string][3]>** current URL
 
 ### grabElementBoundingRect
 
@@ -542,7 +544,7 @@ const width = await I.grabElementBoundingRect('h3', 'width');
 -   `prop`  
 -   `elementSize` **[string][3]?** x, y, width or height of the given element.
 
-Returns **([Promise][9]<DOMRect> | [Promise][9]<[number][11]>)** Element bounding rectangle
+Returns **([Promise][8]<DOMRect> | [Promise][8]<[number][11]>)** Element bounding rectangle
 
 ### grabHAR
 
@@ -568,7 +570,7 @@ let postHTML = await I.grabHTMLFrom('#post');
 -   `locator`  
 -   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][3]>** HTML code for an element
+Returns **[Promise][8]<[string][3]>** HTML code for an element
 
 ### grabHTMLFromAll
 
@@ -584,7 +586,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 -   `locator`  
 -   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][3]>>** HTML code for an element
+Returns **[Promise][8]<[Array][10]<[string][3]>>** HTML code for an element
 
 ### grabNumberOfVisibleElements
 
@@ -599,7 +601,7 @@ let numOfElements = await I.grabNumberOfVisibleElements('p');
 
 -   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[number][11]>** number of visible elements
+Returns **[Promise][8]<[number][11]>** number of visible elements
 
 ### grabPageScrollPosition
 
@@ -610,7 +612,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][8]<PageScrollPosition>** scroll position
 
 ### grabTextFrom
 
@@ -627,7 +629,7 @@ If multiple elements found returns first element.
 
 -   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][3]>** attribute value
+Returns **[Promise][8]<[string][3]>** attribute value
 
 ### grabTextFromAll
 
@@ -642,7 +644,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 -   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][3]>>** attribute value
+Returns **[Promise][8]<[Array][10]<[string][3]>>** attribute value
 
 ### grabTitle
 
@@ -653,7 +655,7 @@ Resumes test execution, so **should be used inside async with `await`** operator
 let title = await I.grabTitle();
 ```
 
-Returns **[Promise][9]<[string][3]>** title
+Returns **[Promise][8]<[string][3]>** title
 
 ### grabValueFrom
 
@@ -669,7 +671,7 @@ let email = await I.grabValueFrom('input[name=email]');
 
 -   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[string][3]>** attribute value
+Returns **[Promise][8]<[string][3]>** attribute value
 
 ### grabValueFromAll
 
@@ -684,7 +686,7 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 -   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][9]<[Array][10]<[string][3]>>** attribute value
+Returns **[Promise][8]<[Array][10]<[string][3]>>** attribute value
 
 ### haveHeader
 
@@ -1159,7 +1161,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 
 #### Parameters
 
--   `fn` **([string][3] | [function][8])** to be executed in browser context.
+-   `fn` **([string][3] | [function][7])** to be executed in browser context.
 -   `argsOrSec` **([Array][10]<any> | [number][11])?** (optional, `1` by default) arguments for function or seconds. 
 -   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait
     ⚠️ returns a _promise_ which is synchronized internally by recorder 
@@ -1239,11 +1241,11 @@ I.waitToHide('#popup');
 
 [6]: https://vuejs.org/v2/api/#Vue-nextTick
 
-[7]: https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2
+[7]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
 
-[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
 
-[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+[9]: https://github.com/segmentio/nightmare#evaluatefn-arg1-arg2
 
 [10]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 

package/docs/helpers/Playwright.md

@@ -74,7 +74,7 @@ Type: [object][5]
 -   `ignoreLog` **[Array][9]<[string][8]>?** An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values][44].
 -   `ignoreHTTPSErrors` **[boolean][32]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
 -   `bypassCSP` **[boolean][32]?** bypass Content Security Policy or CSP
--   `highlightElement` **[boolean][32]?** highlight the interacting elements. Default: false
+-   `highlightElement` **[boolean][32]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
 
 
 

package/docs/helpers/Protractor.md

@@ -530,7 +530,8 @@ let val = await I.executeAsyncScript(function(url, done) {
 
 -   `fn` **([string][9] | [function][12])** function to be executed in browser context.
 -   `args` **...any** to be passed to function.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][13]<any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### executeScript
 
@@ -562,7 +563,8 @@ let date = await I.executeScript(function(el) {
 
 -   `fn` **([string][9] | [function][12])** function to be executed in browser context.
 -   `args` **...any** to be passed to function.
-    ⚠️ returns a _promise_ which is synchronized internally by recorder
+
+Returns **[Promise][13]<any>** script return value⚠️ returns a _promise_ which is synchronized internally by recorder
 
 ### fillField