codeceptjs 3.0.6 → 3.1.2

package/docs/build/Puppeteer.js

@@ -129,8 +129,9 @@ const consoleLogStore = new Console();
  *    }
  * }
  * ```
+ * > Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
  *
-* #### Example #5: Target URL with provided basic authentication
+ * #### Example #5: Target URL with provided basic authentication
  *
  * ```js
  * {
@@ -143,10 +144,25 @@ const consoleLogStore = new Console();
  *    }
  * }
  * ```
+ * #### Troubleshooting
  *
+ * Error Message:  `No usable sandbox!`
+ *
+ * When running Puppeteer on CI try to disable sandbox if you see that message
+ *
+ * ```
+ * helpers: {
+ *  Puppeteer: {
+ *     url: 'http://localhost',
+ *     show: false,
+ *     chrome: {
+ *       args: ['--no-sandbox', '--disable-setuid-sandbox']
+ *     }
+ *   },
+ * }
+ * ```
  *
  *
- * Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
  *
  * ## Access From Helpers
  *
@@ -701,7 +717,7 @@ class Puppeteer extends Helper {
     assertElementExists(els);
 
     // Use manual mouse.move instead of .hover() so the offset can be added to the coordinates
-    const { x, y } = await els[0]._clickablePoint();
+    const { x, y } = await getClickablePoint(els[0]);
     await this.page.mouse.move(x + offsetX, y + offsetY);
     return this._waitForAction();
   }
@@ -790,7 +806,7 @@ class Puppeteer extends Helper {
       const els = await this._locate(locator);
       assertElementExists(els, locator, 'Element');
       await els[0]._scrollIntoViewIfNeeded();
-      const elementCoordinates = await els[0]._clickablePoint();
+      const elementCoordinates = await getClickablePoint(els[0]);
       await this.executeScript((x, y) => window.scrollBy(x, y), elementCoordinates.x + offsetX, elementCoordinates.y + offsetY);
     } else {
       await this.executeScript((x, y) => window.scrollTo(x, y), offsetX, offsetY);
@@ -1047,7 +1063,10 @@ class Puppeteer extends Helper {
    */
   async seeElement(locator) {
     let els = await this._locate(locator);
-    els = await Promise.all(els.map(el => el.boundingBox()));
+    els = (await Promise.all(els.map(el => el.boundingBox() && el))).filter(v => v);
+    // Puppeteer visibility was ignored? | Remove when Puppeteer is fixed
+    els = await Promise.all(els.map(async el => (await el.evaluate(node => window.getComputedStyle(node).visibility !== 'hidden' && window.getComputedStyle(node).display !== 'none')) && el));
+
     return empty('visible elements').negate(els.filter(v => v).fill('ELEMENT'));
   }
 
@@ -1063,7 +1082,10 @@ class Puppeteer extends Helper {
    */
   async dontSeeElement(locator) {
     let els = await this._locate(locator);
-    els = await Promise.all(els.map(el => el.boundingBox()));
+    els = (await Promise.all(els.map(el => el.boundingBox() && el))).filter(v => v);
+    // Puppeteer visibility was ignored? | Remove when Puppeteer is fixed
+    els = await Promise.all(els.map(async el => (await el.evaluate(node => window.getComputedStyle(node).visibility !== 'hidden' && window.getComputedStyle(node).display !== 'none')) && el));
+
     return empty('visible elements').assert(els.filter(v => v).fill('ELEMENT'));
   }
 
@@ -1598,7 +1620,7 @@ class Puppeteer extends Helper {
    * {{ react }}
    */
   async fillField(field, value) {
-    const els = await findFields.call(this, field);
+    const els = await findVisibleFields.call(this, field);
     assertElementExists(els, field, 'Field');
     const el = els[0];
     const tag = await el.getProperty('tagName').then(el => el.jsonValue());
@@ -1640,7 +1662,7 @@ class Puppeteer extends Helper {
    * {{ react }}
    */
   async appendField(field, value) {
-    const els = await findFields.call(this, field);
+    const els = await findVisibleFields.call(this, field);
     assertElementExists(els, field, 'Field');
     await els[0].press('End');
     await els[0].type(value, { delay: this.options.pressKeyDelay });
@@ -1732,7 +1754,7 @@ class Puppeteer extends Helper {
    * 
    */
   async selectOption(select, option) {
-    const els = await findFields.call(this, select);
+    const els = await findVisibleFields.call(this, select);
     assertElementExists(els, select, 'Selectable field');
     const el = els[0];
     if (await el.getProperty('tagName').then(t => t.jsonValue()) !== 'SELECT') {
@@ -1774,7 +1796,10 @@ class Puppeteer extends Helper {
    */
   async grabNumberOfVisibleElements(locator) {
     let els = await this._locate(locator);
-    els = await Promise.all(els.map(el => el.boundingBox()));
+    els = (await Promise.all(els.map(el => el.boundingBox() && el))).filter(v => v);
+    // Puppeteer visibility was ignored? | Remove when Puppeteer is fixed
+    els = await Promise.all(els.map(async el => (await el.evaluate(node => window.getComputedStyle(node).visibility !== 'hidden' && window.getComputedStyle(node).display !== 'none')) && el));
+
     return els.filter(v => v).length;
   }
 
@@ -2452,8 +2477,8 @@ class Puppeteer extends Helper {
     const src = await this._locate(locator);
     assertElementExists(src, locator, 'Slider Element');
 
-    // Note: Using private api ._clickablePoint because the .BoundingBox does not take into account iframe offsets!
-    const sliderSource = await src[0]._clickablePoint();
+    // Note: Using public api .getClickablePoint because the .BoundingBox does not take into account iframe offsets
+    const sliderSource = await getClickablePoint(src[0]);
 
     // Drag start point
     await this.page.mouse.move(sliderSource.x, sliderSource.y, { steps: 5 });
@@ -3202,7 +3227,7 @@ class Puppeteer extends Helper {
 module.exports = Puppeteer;
 
 async function findElements(matcher, locator) {
-  if (locator.react) return findReact(matcher, locator);
+  if (locator.react) return findReact(matcher.executionContext(), locator);
   locator = new Locator(locator, 'css');
   if (!locator.isXPath()) return matcher.$$(locator.simplify());
   return matcher.$x(locator.value);
@@ -3231,7 +3256,7 @@ async function proceedClick(locator, context = null, options = {}) {
 }
 
 async function findClickable(matcher, locator) {
-  if (locator.react) return findReact(matcher, locator);
+  if (locator.react) return findReact(matcher.executionContext(), locator);
   locator = new Locator(locator);
   if (!locator.isFuzzy()) return findElements.call(this, matcher, locator);
 
@@ -3314,6 +3339,12 @@ async function proceedIsChecked(assertType, option) {
   return truth(`checkable ${option}`, 'to be checked')[assertType](selected);
 }
 
+async function findVisibleFields(locator) {
+  const els = await findFields.call(this, locator);
+  const visible = await Promise.all(els.map(el => el.boundingBox()));
+  return els.filter((el, index) => visible[index]);
+}
+
 async function findFields(locator) {
   const matchedLocator = new Locator(locator);
   if (!matchedLocator.isFuzzy()) {
@@ -3344,9 +3375,9 @@ async function proceedDragAndDrop(sourceLocator, destinationLocator) {
   const dst = await this._locate(destinationLocator);
   assertElementExists(dst, destinationLocator, 'Destination Element');
 
-  // Note: Using private api ._clickablePoint becaues the .BoundingBox does not take into account iframe offsets!
-  const dragSource = await src[0]._clickablePoint();
-  const dragDestination = await dst[0]._clickablePoint();
+  // Note: Using public api .getClickablePoint becaues the .BoundingBox does not take into account iframe offsets
+  const dragSource = await getClickablePoint(src[0]);
+  const dragDestination = await getClickablePoint(dst[0]);
 
   // Drag start point
   await this.page.mouse.move(dragSource.x, dragSource.y, { steps: 5 });
@@ -3360,7 +3391,7 @@ async function proceedDragAndDrop(sourceLocator, destinationLocator) {
 }
 
 async function proceedSeeInField(assertType, field, value) {
-  const els = await findFields.call(this, field);
+  const els = await findVisibleFields.call(this, field);
   assertElementExists(els, field, 'Field');
   const el = els[0];
   const tag = await el.getProperty('tagName').then(el => el.jsonValue());
@@ -3493,6 +3524,13 @@ async function targetCreatedHandler(page) {
   }
 }
 
+// BC compatibility for Puppeteer < 10
+async function getClickablePoint(el) {
+  if (el.clickablePoint) return el.clickablePoint();
+  if (el._clickablePoint) return el._clickablePoint();
+  return null;
+}
+
 // List of key values to key definitions
 // https://github.com/GoogleChrome/puppeteer/blob/v1.20.0/lib/USKeyboardLayout.js
 const keyDefinitionMap = {

package/docs/build/REST.js

@@ -59,7 +59,8 @@ class REST extends Helper {
 
     this.options = { ...this.options, ...config };
     this.headers = { ...this.options.defaultHeaders };
-    axios.defaults.headers = this.options.defaultHeaders;
+    this.axios = axios.create();
+    this.axios.defaults.headers = this.options.defaultHeaders;
   }
 
   static _checkRequirements() {
@@ -74,10 +75,12 @@ class REST extends Helper {
    * Executes axios request
    *
    * @param {*} request
+   *
+   * @returns {Promise<*>} response
    */
   async _executeRequest(request) {
     const _debugRequest = { ...request };
-    axios.defaults.timeout = request.timeout || this.options.timeout;
+    this.axios.defaults.timeout = request.timeout || this.options.timeout;
 
     if (this.headers && this.headers.auth) {
       request.auth = this.headers.auth;
@@ -102,7 +105,7 @@ class REST extends Helper {
 
     let response;
     try {
-      response = await axios(request);
+      response = await this.axios(request);
     } catch (err) {
       if (!err.response) throw err;
       this.debugSection('Response', `Response error. Status code: ${err.response.status}`);
@@ -142,6 +145,8 @@ class REST extends Helper {
    *
    * @param {*} url
    * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
+   *
+   * @returns {Promise<*>} response
    */
   async sendGetRequest(url, headers = {}) {
     const request = {
@@ -165,6 +170,8 @@ class REST extends Helper {
    * @param {*} url
    * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
    * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
+   *
+   * @returns {Promise<*>} response
    */
   async sendPostRequest(url, payload = {}, headers = {}) {
     const request = {
@@ -196,6 +203,8 @@ class REST extends Helper {
    * @param {string} url
    * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
    * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
+   *
+   * @returns {Promise<*>} response
    */
   async sendPatchRequest(url, payload = {}, headers = {}) {
     const request = {
@@ -227,6 +236,8 @@ class REST extends Helper {
    * @param {string} url
    * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
    * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
+   *
+   * @returns {Promise<*>} response
    */
   async sendPutRequest(url, payload = {}, headers = {}) {
     const request = {
@@ -253,6 +264,8 @@ class REST extends Helper {
    *
    * @param {*} url
    * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
+   *
+   * @returns {Promise<*>} response
    */
   async sendDeleteRequest(url, headers = {}) {
     const request = {

package/docs/build/WebDriver.js

@@ -396,6 +396,7 @@ class WebDriver extends Helper {
     this.isRunning = false;
     this.sessionWindows = {};
     this.activeSessionName = '';
+    this.customLocatorStrategies = config.customLocatorStrategies;
 
     this._setConfig(config);
 
@@ -503,6 +504,33 @@ class WebDriver extends Helper {
     }
   }
 
+  _lookupCustomLocator(customStrategy) {
+    if (typeof (this.customLocatorStrategies) !== 'object') {
+      return null;
+    }
+    const strategy = this.customLocatorStrategies[customStrategy];
+    return typeof (strategy) === 'function' ? strategy : null;
+  }
+
+  _isCustomLocator(locator) {
+    const locatorObj = new Locator(locator);
+    if (locatorObj.isCustom()) {
+      const customLocator = this._lookupCustomLocator(locatorObj.type);
+      if (customLocator) {
+        return true;
+      }
+      throw new Error('Please define "customLocatorStrategies" as an Object and the Locator Strategy as a "function".');
+    }
+    return false;
+  }
+
+  async _res(locator) {
+    const res = (this._isShadowLocator(locator) || this._isCustomLocator(locator))
+      ? await this._locate(locator)
+      : await this.$$(withStrictLocator(locator));
+    return res;
+  }
+
   async _startBrowser() {
     try {
       if (this.options.multiremote) {
@@ -530,9 +558,22 @@ class WebDriver extends Helper {
     await this._resizeWindowIfNeeded(this.browser, this.options.windowSize);
 
     this.$$ = this.browser.$$.bind(this.browser);
+
+    if (this._isCustomLocatorStrategyDefined()) {
+      Object.keys(this.customLocatorStrategies).forEach(async (customLocator) => {
+        this.debugSection('Weddriver', `adding custom locator strategy: ${customLocator}`);
+        const locatorFunction = this._lookupCustomLocator(customLocator);
+        this.browser.addLocatorStrategy(customLocator, locatorFunction);
+      });
+    }
+
     return this.browser;
   }
 
+  _isCustomLocatorStrategyDefined() {
+    return this.customLocatorStrategies && Object.keys(this.customLocatorStrategies).length;
+  }
+
   async _stopBrowser() {
     if (this.browser && this.isRunning) await this.browser.deleteSession();
   }
@@ -755,17 +796,34 @@ class WebDriver extends Helper {
     }
 
     if (!this.options.smartWait || !smartWait) {
+      if (this._isCustomLocator(locator)) {
+        const locatorObj = new Locator(locator);
+        return this.browser.custom$$(locatorObj.type, locatorObj.value);
+      }
+
       const els = await this.$$(withStrictLocator(locator));
       return els;
     }
 
     await this._smartWait(locator);
 
+    if (this._isCustomLocator(locator)) {
+      const locatorObj = new Locator(locator);
+      return this.browser.custom$$(locatorObj.type, locatorObj.value);
+    }
+
     const els = await this.$$(withStrictLocator(locator));
     await this.defineTimeout({ implicit: 0 });
     return els;
   }
 
+  _grabCustomLocator(locator) {
+    if (typeof locator === 'string') {
+      locator = new Locator(locator);
+    }
+    return locator.value ? locator.value : locator.custom;
+  }
+
   /**
    * Find a checkbox by providing human readable text:
    *
@@ -1079,6 +1137,7 @@ class WebDriver extends Helper {
    * @param {CodeceptJS.StringOrSecret} value text value to fill.
    * 
    * {{ react }}
+   * {{ custom }}
    *
    */
   async fillField(field, value) {
@@ -1462,7 +1521,6 @@ class WebDriver extends Helper {
    * @param {string} attr attribute name.
    * @returns {Promise<string[]>} attribute value
    * 
-   * Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
    */
   async grabAttributeFromAll(locator, attr) {
     const res = await this._locate(locator, true);
@@ -1483,7 +1541,6 @@ class WebDriver extends Helper {
    * @param {string} attr attribute name.
    * @returns {Promise<string>} attribute value
    * 
-   * Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
    */
   async grabAttributeFrom(locator, attr) {
     const attrs = await this.grabAttributeFromAll(locator, attr);
@@ -1723,7 +1780,7 @@ class WebDriver extends Helper {
    *
    */
   async seeElementInDOM(locator) {
-    const res = await this.$$(withStrictLocator(locator));
+    const res = await this._res(locator);
     return empty('elements').negate(res);
   }
 
@@ -1738,7 +1795,7 @@ class WebDriver extends Helper {
    *
    */
   async dontSeeElementInDOM(locator) {
-    const res = await this.$$(withStrictLocator(locator));
+    const res = await this._res(locator);
     return empty('elements').assert(res);
   }
 
@@ -2787,7 +2844,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `element (${new Locator(locator)}) still not enabled after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       if (!res || res.length === 0) {
         return false;
       }
@@ -2823,7 +2880,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `element (${locator}) still not present on page after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       return res && res.length;
     }, { timeout: aSec * 1000, timeoutMsg: `element (${locator}) still not present on page after ${aSec} sec` });
   }
@@ -3046,9 +3103,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `element (${new Locator(locator)}) still not visible after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = (this._isShadowLocator(locator))
-        ? await this._locate(withStrictLocator(locator))
-        : await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       if (!res || res.length === 0) return false;
       const selected = await forEachAsync(res, async el => el.isDisplayed());
       if (Array.isArray(selected)) {
@@ -3083,7 +3138,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `The number of elements (${new Locator(locator)}) is not ${num} after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       if (!res || res.length === 0) return false;
       let selected = await forEachAsync(res, async el => el.isDisplayed());
 
@@ -3115,7 +3170,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `element (${new Locator(locator)}) still visible after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       if (!res || res.length === 0) return true;
       const selected = await forEachAsync(res, async el => el.isDisplayed());
       return !selected.length;
@@ -3152,7 +3207,7 @@ class WebDriver extends Helper {
     const aSec = sec || this.options.waitForTimeout;
     if (isWebDriver5()) {
       return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
+        const res = await this._res(locator);
         if (!res || res.length === 0) {
           return true;
         }
@@ -3160,7 +3215,7 @@ class WebDriver extends Helper {
       }, aSec * 1000, `element (${new Locator(locator)}) still on page after ${aSec} sec`);
     }
     return this.browser.waitUntil(async () => {
-      const res = await this.$$(withStrictLocator(locator));
+      const res = await this._res(locator);
       if (!res || res.length === 0) {
         return true;
       }
@@ -3563,12 +3618,9 @@ async function proceedSee(assertType, text, context, strict = false) {
   }
 
   const smartWaitEnabled = assertType === 'assert';
-
   const res = await this._locate(withStrictLocator(context), smartWaitEnabled);
   assertElementExists(res, context);
-
   const selected = await forEachAsync(res, async el => this.browser.getElementText(getElementId(el)));
-
   if (strict) {
     if (Array.isArray(selected) && selected.length !== 0) {
       return selected.map(elText => equals(description)[assertType](text, elText));
@@ -3636,6 +3688,11 @@ async function filterAsync(array, callback) {
 
 async function findClickable(locator, locateFn) {
   locator = new Locator(locator);
+
+  if (this._isCustomLocator(locator)) {
+    return locateFn(locator.value);
+  }
+
   if (locator.isAccessibilityId() && !this.isWeb) return locateFn(locator, true);
   if (!locator.isFuzzy()) return locateFn(locator, true);
 
@@ -3657,6 +3714,10 @@ async function findClickable(locator, locateFn) {
 async function findFields(locator) {
   locator = new Locator(locator);
 
+  if (this._isCustomLocator(locator)) {
+    return this._locate(locator);
+  }
+
   if (locator.isAccessibilityId() && !this.isWeb) return this._locate(locator, true);
   if (!locator.isFuzzy()) return this._locate(locator, true);
 
@@ -3762,6 +3823,10 @@ async function findCheckable(locator, locateFn) {
   let els;
   locator = new Locator(locator);
 
+  if (this._isCustomLocator(locator)) {
+    return locateFn(locator.value);
+  }
+
   if (locator.isAccessibilityId() && !this.isWeb) return locateFn(locator, true);
   if (!locator.isFuzzy()) return locateFn(locator, true);
 
@@ -3807,6 +3872,7 @@ function getElementId(el) {
   if (el.ELEMENT) {
     return el.ELEMENT;
   }
+
   return null;
 }
 

package/docs/changelog.md

@@ -7,13 +7,97 @@ layout: Section
 
 # Releases
 
+## 3.1.2
+
+🛩️ Features:
+
+* Added `coverage` plugin to generate code coverage for Playwright & Puppeteer. By **[anirudh-modi](https://github.com/anirudh-modi)**
+* Added `subtitle` plugin to generate subtitles for videos recorded with Playwright. By **[anirudh-modi](https://github.com/anirudh-modi)**
+* Configuration: `config.tests` to accept array of file patterns. See [#2994](https://github.com/codeceptjs/CodeceptJS/issues/2994) by **[monsteramba](https://github.com/monsteramba)**
+
+```js
+exports.config = {
+  tests: ['./*_test.js','./sampleTest.js'],
+  // ... 
+}
+```
+* Notification is shown for test files without `Feature()`. See [#3011](https://github.com/codeceptjs/CodeceptJS/issues/3011) by **[PeterNgTr](https://github.com/PeterNgTr)**
+
+🐛 Bugfixes:
+
+* **[Playwright]** Fixed [#2986](https://github.com/codeceptjs/CodeceptJS/issues/2986) error is thrown when deleting a missing video. Fix by **[hatufacci](https://github.com/hatufacci)** 
+* Fixed false positive result when invalid function is called in a helper. See [#2997](https://github.com/codeceptjs/CodeceptJS/issues/2997) by **[abhimanyupandian](https://github.com/abhimanyupandian)**
+* **[Appium]** Removed full page mode for `saveScreenshot`. See [#3002](https://github.com/codeceptjs/CodeceptJS/issues/3002) by **[nlespiaucq](https://github.com/nlespiaucq)**
+* **[Playwright]** Fixed [#3003](https://github.com/codeceptjs/CodeceptJS/issues/3003) saving trace for a test with a long name. Fix by **[hatufacci](https://github.com/hatufacci)** 
+
+🎱 Other:
+
+* Deprecated `puppeteerCoverage` plugin in favor of `coverage` plugin.
+
+## 3.1.1
+
+* **[Appium]** Fixed [#2759](https://github.com/codeceptjs/CodeceptJS/issues/2759)
+ `grabNumberOfVisibleElements`, `grabAttributeFrom`, `grabAttributeFromAll` to allow id locators.
+
+## 3.1.0
+
+* **[Plawyright]** Updated to Playwright 1.13
+* **[Playwright]** **Possible breaking change**: `BrowserContext` is initialized before each test and closed after. This behavior matches recommendation from Playwright team to use different contexts for tests.
+* **[Puppeteer]** Updated to Puppeteer 10.2.
+* **[Protractor]** Helper deprecated
+
+🛩️ Features:
+
+* **[Playwright]** Added recording of [video](https://codecept.io/playwright/#video) and [traces](https://codecept.io/playwright/#trace) by **[davertmik](https://github.com/davertmik)**
+* **[Playwritght]** [Mocking requests](https://codecept.io/playwright/#mocking-network-requests) implemented via `route` API of Playwright by **[davertmik](https://github.com/davertmik)**
+* **[Playwright]** Added **support for [React locators](https://codecept.io/react/#locators)** in [#2912](https://github.com/codeceptjs/CodeceptJS/issues/2912) by **[AAAstorga](https://github.com/AAAstorga)**
+
+🐛 Bugfixes:
+
+* **[Puppeteer]** Fixed [#2244](https://github.com/codeceptjs/CodeceptJS/issues/2244) `els[0]._clickablePoint is not a function` by **[karunandrii](https://github.com/karunandrii)**.
+* **[Puppeteer]** Fixed `fillField` to check for invisible elements. See [#2916](https://github.com/codeceptjs/CodeceptJS/issues/2916) by **[anne-open-xchange](https://github.com/anne-open-xchange)** 
+* **[Playwright]** Reset of dialog event listener before registration of new one. [#2946](https://github.com/codeceptjs/CodeceptJS/issues/2946) by **[nikocanvacom](https://github.com/nikocanvacom)** 
+* Fixed running Gherkin features with `run-multiple` using chunks. See [#2900](https://github.com/codeceptjs/CodeceptJS/issues/2900) by **[andrenoberto](https://github.com/andrenoberto)**
+* Fixed [#2937](https://github.com/codeceptjs/CodeceptJS/issues/2937) broken typings for subfolders on Windows by **[jancorvus](https://github.com/jancorvus)**
+* Fixed issue where cucumberJsonReporter not working with fakerTransform plugin. See [#2942](https://github.com/codeceptjs/CodeceptJS/issues/2942) by **[ilangv](https://github.com/ilangv)** 
+* Fixed [#2952](https://github.com/codeceptjs/CodeceptJS/issues/2952) finished job with status code 0 when playwright cannot connect to remote wss url. By **[davertmik](https://github.com/davertmik)**
+
+
+## 3.0.7
+
+📖 Documentation fixes:
+
+* Remove broken link from `Nightmare helper`. See [#2860](https://github.com/codeceptjs/CodeceptJS/issues/2860) by **[Arhell](https://github.com/Arhell)**
+* Fixed broken links in `playwright.md`. See [#2848](https://github.com/codeceptjs/CodeceptJS/issues/2848) by **[johnhoodjr](https://github.com/johnhoodjr)**
+* Fix mocha-multi config example. See [#2881](https://github.com/codeceptjs/CodeceptJS/issues/2881) by **[rimesc](https://github.com/rimesc)**
+* Fix small errors in email documentation file. See [#2884](https://github.com/codeceptjs/CodeceptJS/issues/2884) by **[mkrtchian](https://github.com/mkrtchian)**
+* Improve documentation for `Sharing Data Between Workers` section. See [#2891](https://github.com/codeceptjs/CodeceptJS/issues/2891) by **[ngraf](https://github.com/ngraf)**
+
+🛩️ Features:
+
+* **[WebDriver]** Shadow DOM Support for `Webdriver`. See [#2741](https://github.com/codeceptjs/CodeceptJS/issues/2741) by **[gkushang](https://github.com/gkushang)**
+* [Release management] Introduce the versioning automatically, it follows the semantics versioning. See [#2883](https://github.com/codeceptjs/CodeceptJS/issues/2883) by **[PeterNgTr](https://github.com/PeterNgTr)**
+* Adding opts into `Scenario.skip` that it would be useful for building reports. See [#2867](https://github.com/codeceptjs/CodeceptJS/issues/2867) by **[AlexKo4](https://github.com/AlexKo4)**
+* Added support for attaching screenshots to [cucumberJsonReporter](https://github.com/ktryniszewski-mdsol/codeceptjs-cucumber-json-reporter) See [#2888](https://github.com/codeceptjs/CodeceptJS/issues/2888) by **[fijijavis](https://github.com/fijijavis)**
+* Supported config file for `codeceptjs shell` command. See [#2895](https://github.com/codeceptjs/CodeceptJS/issues/2895) by **[PeterNgTr](https://github.com/PeterNgTr)**:
+
+```
+npx codeceptjs shell -c foo.conf.js
+```
+
+Bug fixes:
+* **[GraphQL]** Use a helper-specific instance of Axios to avoid contaminating global defaults. See [#2868](https://github.com/codeceptjs/CodeceptJS/issues/2868) by **[vanvoljg](https://github.com/vanvoljg)**
+* A default system color is used when passing non supported system color when using I.say(). See [#2874](https://github.com/codeceptjs/CodeceptJS/issues/2874) by **[PeterNgTr](https://github.com/PeterNgTr)**
+* **[Playwright]** Avoid the timout due to calling the click on invisible elements. See [#2875](https://github.com/codeceptjs/CodeceptJS/issues/2875) by cbayer97
+
+
 ## 3.0.6
 
-* **[Playwright]** Added `electron` as a browser to config. See [#2834](https://github.com/codeceptjs/CodeceptJS/issues/2834) by **[cbayer97](https://github.com/cbayer97)**  
+* **[Playwright]** Added `electron` as a browser to config. See [#2834](https://github.com/codeceptjs/CodeceptJS/issues/2834) by **[cbayer97](https://github.com/cbayer97)**
 * **[Playwright]** Implemented `launchPersistentContext` to be able to launch persistent remote browsers. See [#2817](https://github.com/codeceptjs/CodeceptJS/issues/2817) by **[brunoqueiros](https://github.com/brunoqueiros)**. Fixes [#2376](https://github.com/codeceptjs/CodeceptJS/issues/2376).
 * Fixed printing logs and stack traces for `run-workers`. See [#2857](https://github.com/codeceptjs/CodeceptJS/issues/2857) by **[haveac1gar](https://github.com/haveac1gar)**. Fixes [#2621](https://github.com/codeceptjs/CodeceptJS/issues/2621), [#2852](https://github.com/codeceptjs/CodeceptJS/issues/2852)
-* Emit custom messages from worker to the main thread. See [#2824](https://github.com/codeceptjs/CodeceptJS/issues/2824) by **[jccguimaraes](https://github.com/jccguimaraes)** 
-* Improved workers processes output. See [#2804](https://github.com/codeceptjs/CodeceptJS/issues/2804) by **[drfiresign](https://github.com/drfiresign)** 
+* Emit custom messages from worker to the main thread. See [#2824](https://github.com/codeceptjs/CodeceptJS/issues/2824) by **[jccguimaraes](https://github.com/jccguimaraes)**
+* Improved workers processes output. See [#2804](https://github.com/codeceptjs/CodeceptJS/issues/2804) by **[drfiresign](https://github.com/drfiresign)**
 * BDD. Added ability to use an array of feature files inside config in `gherkin.features`. See [#2814](https://github.com/codeceptjs/CodeceptJS/issues/2814) by **[jbergeronjr](https://github.com/jbergeronjr)**
 
 ```js
@@ -22,8 +106,8 @@ layout: Section
   "./features/api_features/*.feature"
 ],
 ```
-* Added `getQueueId` to reporter to rerun a specific promise. See [#2837](https://github.com/codeceptjs/CodeceptJS/issues/2837) by **[jonatask](https://github.com/jonatask)** 
-* **Added `fakerTransform` plugin** to use faker data in Gherkin scenarios. See [#2854](https://github.com/codeceptjs/CodeceptJS/issues/2854) by **[adrielcodeco](https://github.com/adrielcodeco)** 
+* Added `getQueueId` to reporter to rerun a specific promise. See [#2837](https://github.com/codeceptjs/CodeceptJS/issues/2837) by **[jonatask](https://github.com/jonatask)**
+* **Added `fakerTransform` plugin** to use faker data in Gherkin scenarios. See [#2854](https://github.com/codeceptjs/CodeceptJS/issues/2854) by **[adrielcodeco](https://github.com/adrielcodeco)**
 
 ```feature
 Scenario Outline: ...
@@ -35,7 +119,7 @@ Scenario Outline: ...
   | productName          | customer              | email              | anythingMore |
   | {{commerce.product}} | Dr. {{name.findName}} | {{internet.email}} | staticData   |
 ```
-* **[REST]** Use class instance of axios, not the global instance, to avoid contaminating global configuration. [#2846](https://github.com/codeceptjs/CodeceptJS/issues/2846) by **[vanvoljg](https://github.com/vanvoljg)** 
+* **[REST]** Use class instance of axios, not the global instance, to avoid contaminating global configuration. [#2846](https://github.com/codeceptjs/CodeceptJS/issues/2846) by **[vanvoljg](https://github.com/vanvoljg)**
 * **[Appium]** Added `tunnelIdentifier` config option to provide tunnel for SauceLabs. See [#2832](https://github.com/codeceptjs/CodeceptJS/issues/2832) by **[gurjeetbains](https://github.com/gurjeetbains)**
 
 ## 3.0.5
@@ -43,9 +127,9 @@ Scenario Outline: ...
 
 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)**  
+* **[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)** 
+* 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.
@@ -144,7 +228,7 @@ Scenario('title', (I, loginPage) => {});
 Scenario('title', ({ I, loginPage }) => {});
 ```
 
-* **BREAKING** Replaced bootstrap/teardown scripts to accept only functions or async functions. Async function with callback (with done parameter) should be replaced with async/await. [See our upgrde guide](https://bit.ly/codecept3Up).
+* **BREAKING** Replaced bootstrap/teardown scripts to accept only functions or async functions. Async function with callback (with done parameter) should be replaced with async/await. [See our upgrade guide](https://bit.ly/codecept3Up).
 * **[TypeScript guide](/typescript)** and [boilerplate project](https://github.com/codeceptjs/typescript-boilerplate)
 * [tryTo](/plugins/#tryto) and [pauseOnFail](/plugins/#pauseOnFail) plugins installed by default
 * Introduced one-line installer: