codeceptjs 3.5.9-beta.1 → 3.5.9-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.5.9-beta.1",
+  "version": "3.5.9-beta.2",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -80,9 +80,9 @@
     "chai-string": "^1.5.0",
     "chalk": "4.1.2",
     "commander": "11.0.0",
+    "convert-cssxpath": "1.0.2",
     "cross-spawn": "7.0.3",
-    "css-to-xpath": "0.1.0",
-    "envinfo": "7.8.1",
+    "envinfo": "7.11.0",
     "escape-string-regexp": "4.0.0",
     "figures": "3.2.0",
     "fn-args": "4.0.0",
@@ -91,7 +91,7 @@
     "html-minifier": "4.0.0",
     "inquirer": "6.5.2",
     "joi": "17.11.0",
-    "js-beautify": "1.14.9",
+    "js-beautify": "1.14.11",
     "lodash.clonedeep": "4.5.0",
     "lodash.merge": "4.6.2",
     "mkdirp": "1.0.4",

package/typings/promiseBasedTypes.d.ts

@@ -458,7 +458,7 @@ declare namespace CodeceptJS {
          * Switch to the specified context.
          * @param context - the context to switch to
          */
-        _switchToContext(context: any): Promise<any>;
+        switchToContext(context: any): Promise<any>;
         /**
          * Switches to web context.
          * If no context is provided switches to the first detected web context
@@ -2761,6 +2761,21 @@ declare namespace CodeceptJS {
      * * `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
@@ -3135,6 +3150,21 @@ declare namespace CodeceptJS {
          * ```
          */
         refreshPage(): Promise<any>;
+        /**
+         * 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 harFilePath - Path to recorded HAR file
+         * @param [opts] - [Options for replaying from HAR](https://playwright.dev/docs/api/class-page#page-route-from-har)
+         */
+        replayFromHar(harFilePath: string, opts?: any): Promise<any>;
         /**
          * Scroll page to the top.
          *

package/typings/types.d.ts

@@ -458,7 +458,7 @@ declare namespace CodeceptJS {
          * Switch to the specified context.
          * @param context - the context to switch to
          */
-        _switchToContext(context: any): void;
+        switchToContext(context: any): void;
         /**
          * Switches to web context.
          * If no context is provided switches to the first detected web context
@@ -2848,6 +2848,7 @@ declare namespace CodeceptJS {
      * @property [ignoreHTTPSErrors] - Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
      * @property [bypassCSP] - bypass Content Security Policy or CSP
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+     * @property [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).
      */
     type PlaywrightConfig = {
         url?: string;
@@ -2884,6 +2885,7 @@ declare namespace CodeceptJS {
         ignoreHTTPSErrors?: boolean;
         bypassCSP?: boolean;
         highlightElement?: boolean;
+        recordHar?: any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -2929,6 +2931,21 @@ declare namespace CodeceptJS {
      * * `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
@@ -3324,6 +3341,22 @@ declare namespace CodeceptJS {
          * @returns automatically synchronized promise through #recorder
          */
         refreshPage(): void;
+        /**
+         * 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 harFilePath - Path to recorded HAR file
+         * @param [opts] - [Options for replaying from HAR](https://playwright.dev/docs/api/class-page#page-route-from-har)
+         * @returns Promise<void>
+         */
+        replayFromHar(harFilePath: string, opts?: any): any;
         /**
          * Scroll page to the top.
          *