codeceptjs 3.5.8 → 3.5.9-beta.2

package/docs/build/Playwright.js

@@ -94,6 +94,7 @@ const pathSeparator = path.sep;
  * @prop {boolean} [ignoreHTTPSErrors] - Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
  * @prop {boolean} [bypassCSP] - bypass Content Security Policy or CSP
  * @prop {boolean} [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+ * @prop {object} [recordHar] - record HAR and will be saved to `output/har`. See more of [HAR options](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har).
  */
 const config = {};
 
@@ -141,6 +142,21 @@ const config = {};
  * * `trace`: enables trace recording for failed tests; trace are saved into `output/trace` folder
  * * `keepTraceForPassedTests`: - save trace for passed tests
  *
+ * #### HAR Recording Customization
+ *
+ * A HAR file is an HTTP Archive file that contains a record of all the network requests that are made when a page is loaded.
+ * It contains information about the request and response headers, cookies, content, timings, and more. You can use HAR files to mock network requests in your tests.
+ * HAR will be saved to `output/har`. More info could be found here https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har.
+ *
+ * ```
+ * ...
+ * recordHar: {
+ *     mode: 'minimal', // possible values: 'minimal'|'full'.
+ *     content: 'embed' // possible values:  "omit"|"embed"|"attach".
+ * }
+ * ...
+ *```
+ *
  * #### Example #1: Wait for 0 network connections.
  *
  * ```js
@@ -455,7 +471,8 @@ class Playwright extends Helper {
     }
   }
 
-  async _before() {
+  async _before(test) {
+    this.currentRunningTest = test;
     recorder.retry({
       retries: 5,
       when: err => {
@@ -487,6 +504,15 @@ class Playwright extends Helper {
       }
       if (this.options.bypassCSP) contextOptions.bypassCSP = this.options.bypassCSP;
       if (this.options.recordVideo) contextOptions.recordVideo = this.options.recordVideo;
+      if (this.options.recordHar) {
+        const harExt = this.options.recordHar.content && this.options.recordHar.content === 'attach' ? 'zip' : 'har';
+        const fileName = `${`${global.output_dir}${path.sep}har${path.sep}${uuidv4()}_${clearString(this.currentRunningTest.title)}`.slice(0, 245)}.${harExt}`;
+        const dir = path.dirname(fileName);
+        if (!fileExists(dir)) fs.mkdirSync(dir);
+        this.options.recordHar.path = fileName;
+        this.currentRunningTest.artifacts.har = fileName;
+        contextOptions.recordHar = this.options.recordHar;
+      }
       if (this.storageState) contextOptions.storageState = this.storageState;
       if (this.options.userAgent) contextOptions.userAgent = this.options.userAgent;
       if (this.options.locale) contextOptions.locale = this.options.locale;
@@ -698,7 +724,7 @@ class Playwright extends Helper {
    * I.seeInPopup('Popup text');
    * ```
    * @param {string} text value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeInPopup(text) {
@@ -842,6 +868,7 @@ class Playwright extends Helper {
     this.context = null;
     this.frame = null;
     popupStore.clear();
+    if (this.options.recordHar) await this.browserContext.close();
     await this.browser.close();
   }
 
@@ -904,7 +931,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} url url path or global url.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async amOnPage(url) {
@@ -943,7 +970,7 @@ class Playwright extends Helper {
    * 
    * @param {number} width width in pixels or `maximize`.
    * @param {number} height height in pixels.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * Unlike other drivers Playwright changes the size of a viewport, not the window!
@@ -997,7 +1024,7 @@ class Playwright extends Helper {
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
    * @param {number} [offsetX=0] (optional, `0` by default) X-axis offset.
    * @param {number} [offsetY=0] (optional, `0` by default) Y-axis offset.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -1024,7 +1051,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
    * @param {any} [options] Playwright only: [Additional options](https://playwright.dev/docs/api/class-locator#locator-focus) for available options object as 2nd argument.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -1054,7 +1081,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
    * @param {any} [options] Playwright only: [Additional options](https://playwright.dev/docs/api/class-locator#locator-blur) for available options object as 2nd argument.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -1107,7 +1134,7 @@ class Playwright extends Helper {
    * 
    * @param {LocatorOrString} srcElement located by CSS|XPath|strict locator.
    * @param {LocatorOrString} destElement located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    * @param {any} [options] [Additional options](https://playwright.dev/docs/api/class-page#page-drag-and-drop) can be passed as 3rd argument.
    *
@@ -1165,20 +1192,47 @@ class Playwright extends Helper {
    * ```js
    * I.refreshPage();
    * ```
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async refreshPage() {
     return this.page.reload({ timeout: this.options.getPageTimeout, waitUntil: this.options.waitForNavigation });
   }
 
+  /**
+   * Replaying from HAR
+   *
+   * ```js
+   *  // Replay API requests from HAR.
+   *  // Either use a matching response from the HAR,
+   *  // or abort the request if nothing matches.
+   *    I.replayFromHar('./output/har/something.har', { url: "*\/**\/api/v1/fruits" });
+   *    I.amOnPage('https://demo.playwright.dev/api-mocking');
+   *    I.see('CodeceptJS');
+   * ```
+   *
+   * @param {string} harFilePath Path to recorded HAR file
+   * @param {object} [opts] [Options for replaying from HAR](https://playwright.dev/docs/api/class-page#page-route-from-har)
+   *
+   * @returns Promise<void>
+   */
+  async replayFromHar(harFilePath, opts) {
+    const file = path.join(global.codecept_dir, harFilePath);
+
+    if (!fileExists(file)) {
+      throw new Error(`File at ${file} cannot be found on local system`);
+    }
+
+    await this.page.routeFromHAR(harFilePath, opts);
+  }
+
   /**
    * Scroll page to the top.
    * 
    * ```js
    * I.scrollPageToTop();
    * ```
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   scrollPageToTop() {
@@ -1193,7 +1247,7 @@ class Playwright extends Helper {
    * ```js
    * I.scrollPageToBottom();
    * ```
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async scrollPageToBottom() {
@@ -1222,7 +1276,7 @@ class Playwright extends Helper {
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
    * @param {number} [offsetX=0] (optional, `0` by default) X-axis offset.
    * @param {number} [offsetY=0] (optional, `0` by default) Y-axis offset.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async scrollTo(locator, offsetX = 0, offsetY = 0) {
@@ -1252,7 +1306,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} text text value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeInTitle(text) {
@@ -1291,7 +1345,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} text value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeTitleEquals(text) {
@@ -1307,7 +1361,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} text value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeInTitle(text) {
@@ -1532,7 +1586,7 @@ class Playwright extends Helper {
    * I.seeElement('#modal');
    * ```
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -1550,7 +1604,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|Strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -1568,7 +1622,7 @@ class Playwright extends Helper {
    * I.seeElementInDOM('#modal');
    * ```
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeElementInDOM(locator) {
@@ -1584,7 +1638,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|Strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeElementInDOM(locator) {
@@ -1650,7 +1704,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
    * @param {?CodeceptJS.LocatorOrString | null} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * @param {any} [options] [Additional options](https://playwright.dev/docs/api/class-page#page-click) for click available as 3rd argument.
@@ -1707,7 +1761,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async forceClick(locator, context = null) {
@@ -1727,7 +1781,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -1750,7 +1804,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator clickable element located by CSS|XPath|strict locator.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -1772,7 +1826,7 @@ class Playwright extends Helper {
    * ```
    * @param {CodeceptJS.LocatorOrString} field checkbox located by label | name | CSS | XPath | strict locator.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-check) for check available as 3rd argument.
@@ -1804,7 +1858,7 @@ class Playwright extends Helper {
    * ```
    * @param {CodeceptJS.LocatorOrString} field checkbox located by label | name | CSS | XPath | strict locator.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * [Additional options](https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck) for uncheck available as 3rd argument.
@@ -1833,7 +1887,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeCheckboxIsChecked(field) {
@@ -1850,7 +1904,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeCheckboxIsChecked(field) {
@@ -1869,7 +1923,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} key name of key to press down.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async pressKeyDown(key) {
@@ -1890,7 +1944,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} key name of key to release.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async pressKeyUp(key) {
@@ -1959,7 +2013,7 @@ class Playwright extends Helper {
    * - `'Tab'`
    * 
    * @param {string|string[]} key key or array of keys to press.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
@@ -2010,7 +2064,7 @@ class Playwright extends Helper {
    * 
    * @param {string|string[]} key or array of keys to type.
    * @param {?number} [delay=null] (optional) delay in ms between key presses
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async type(keys, delay = null) {
@@ -2041,7 +2095,7 @@ class Playwright extends Helper {
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
    * @param {CodeceptJS.StringOrSecret} value text value to fill.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2100,7 +2154,7 @@ class Playwright extends Helper {
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator
    * @param {string} value text value to append.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -2126,7 +2180,7 @@ class Playwright extends Helper {
    * ```
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
    * @param {CodeceptJS.StringOrSecret} value value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeInField(field, value) {
@@ -2145,7 +2199,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
    * @param {CodeceptJS.StringOrSecret} value value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeInField(field, value) {
@@ -2165,7 +2219,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
    * @param {string} pathToFile local file path relative to codecept.conf.ts or codecept.conf.js config file.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2202,7 +2256,7 @@ class Playwright extends Helper {
    * ```
    * @param {LocatorOrString} select field located by label|name|CSS|XPath|strict locator.
    * @param {string|Array<*>} option visible text or value of option.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async selectOption(select, option) {
@@ -2244,7 +2298,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} url a fragment to check
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeInCurrentUrl(url) {
@@ -2255,7 +2309,7 @@ class Playwright extends Helper {
    * Checks that current url does not contain a provided fragment.
    * 
    * @param {string} url value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeInCurrentUrl(url) {
@@ -2273,7 +2327,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} url value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeCurrentUrlEquals(url) {
@@ -2290,7 +2344,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} url value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeCurrentUrlEquals(url) {
@@ -2308,7 +2362,7 @@ class Playwright extends Helper {
    * ```
    * @param {string} text expected on page.
    * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -2326,7 +2380,7 @@ class Playwright extends Helper {
    * 
    * @param {string} text element value to check.
    * @param {CodeceptJS.LocatorOrString?} [context=null]  element located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeTextEquals(text, context = null) {
@@ -2344,7 +2398,7 @@ class Playwright extends Helper {
    * 
    * @param {string} text which is not present.
    * @param {CodeceptJS.LocatorOrString} [context] (optional) element located by CSS|XPath|strict locator in which to perfrom search.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -2406,7 +2460,7 @@ class Playwright extends Helper {
    * I.seeInSource('<h1>Green eggs &amp; ham</h1>');
    * ```
    * @param {string} text value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async seeInSource(text) {
@@ -2422,7 +2476,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} value to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeInSource(text) {
@@ -2441,7 +2495,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} num number of elements.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -2461,7 +2515,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} num number of elements.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    *
@@ -2487,7 +2541,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {Cookie|Array<Cookie>} cookie a cookie object or array of cookie objects.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async setCookie(cookie) {
@@ -2505,7 +2559,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} name cookie name.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2522,7 +2576,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {string} name cookie name.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async dontSeeCookie(name) {
@@ -2559,16 +2613,15 @@ class Playwright extends Helper {
    * 
    * ```js
    * I.clearCookie();
-   * I.clearCookie('test');
+   * I.clearCookie('test'); // Playwright currently doesn't support clear a particular cookie name
    * ```
    * 
    * @param {?string} [cookie=null] (optional, `null` by default) cookie name
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
    * 
    */
   async clearCookie() {
     // Playwright currently doesn't support to delete a certain cookie
-    // https://github.com/microsoft/playwright/blob/main/docs/api.md#class-browsercontext
+    // https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md#async-method-browsercontextclearcookies
     if (!this.browserContext) return;
     return this.browserContext.clearCookies();
   }
@@ -2793,7 +2846,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
    * @param {object} cssProperties object with CSS properties and their values to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2839,7 +2892,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
    * @param {object} attributes attributes and their values to check.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2879,7 +2932,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator located by label|name|CSS|XPath|strict locator.
    * @param {number} offsetX position to drag.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2957,7 +3010,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {string} fileName file name to save.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -2983,7 +3036,7 @@ class Playwright extends Helper {
    * 
    * @param {string} fileName file name to save.
    * @param {boolean} [fullPage=false] (optional, `false` by default) flag to enable fullscreen screenshot mode.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async saveScreenshot(fileName, fullPage) {
@@ -3084,6 +3137,10 @@ class Playwright extends Helper {
         test.artifacts[`trace_${sessionName}`] = await saveTraceForContext(this.sessionPages[sessionName].context, `${test.title}_${sessionName}.failed`);
       }
     }
+
+    if (this.options.recordHar) {
+      test.artifacts.har = this.currentRunningTest.artifacts.har;
+    }
   }
 
   async _passed(test) {
@@ -3111,6 +3168,10 @@ class Playwright extends Helper {
         await this.browserContext.tracing.stop();
       }
     }
+
+    if (this.options.recordHar) {
+      test.artifacts.har = this.currentRunningTest.artifacts.har;
+    }
   }
 
   /**
@@ -3121,7 +3182,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {number} sec number of second to wait.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async wait(sec) {
@@ -3136,7 +3197,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional) time in seconds to wait, 1 by default.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForEnabled(locator, sec) {
@@ -3172,7 +3233,7 @@ class Playwright extends Helper {
    * @param {LocatorOrString} field input field.
    * @param {string }value expected value.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForValue(field, value, sec) {
@@ -3209,7 +3270,7 @@ class Playwright extends Helper {
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} num number of elements.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -3251,7 +3312,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForClickable(locator, waitTimeout) {
@@ -3270,7 +3331,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    */
@@ -3296,7 +3357,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    *
    * This method accepts [React selectors](https://codecept.io/react).
@@ -3337,7 +3398,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForInvisible(locator, sec) {
@@ -3377,7 +3438,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitToHide(locator, sec) {
@@ -3421,7 +3482,7 @@ class Playwright extends Helper {
    * 
    * @param {string} urlPart value to check.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitInUrl(urlPart, sec = null) {
@@ -3450,7 +3511,7 @@ class Playwright extends Helper {
    * 
    * @param {string} urlPart value to check.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitUrlEquals(urlPart, sec = null) {
@@ -3487,7 +3548,7 @@ class Playwright extends Helper {
    * @param {string }text to wait for.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
    * @param {CodeceptJS.LocatorOrString} [context] (optional) element located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForText(text, sec = null, context = null) {
@@ -3572,7 +3633,7 @@ class Playwright extends Helper {
    * ```
    * 
    * @param {?CodeceptJS.LocatorOrString} [locator=null] (optional, `null` by default) element located by CSS|XPath|strict locator.
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async switchTo(locator) {
@@ -3644,7 +3705,7 @@ class Playwright extends Helper {
    * @param {string|function} fn to be executed in browser context.
    * @param {any[]|number} [argsOrSec] (optional, `1` by default) arguments for function or seconds.
    * @param {number} [sec] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForFunction(fn, argsOrSec = null, sec = null) {
@@ -3713,7 +3774,7 @@ class Playwright extends Helper {
    * 
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async waitForDetached(locator, sec) {
@@ -3764,7 +3825,7 @@ class Playwright extends Helper {
    *   loadEventEnd: 241
    * }
    * ```
-   * @returns {Promise<void>} automatically synchronized promise through #recorder
+   * @returns {void} automatically synchronized promise through #recorder
    * 
    */
   async grabDataFromPerformanceTiming() {
@@ -4465,7 +4526,7 @@ async function proceedSee(assertType, text, context, strict = false) {
   if (!context) {
     const el = await this.context;
 
-    allText = el.constructor.name ? [await el.locator('body').innerText()] : [await el.innerText()];
+    allText = el.constructor.name !== 'Locator' ? [await el.locator('body').innerText()] : [await el.innerText()];
 
     description = 'web application';
   } else {