codeceptjs 3.6.1 → 3.6.2-beta.1

package/lib/helper/Playwright.js

@@ -417,7 +417,14 @@ class Playwright extends Helper {
     }
 
     if (this.options.video) {
-      this.options.recordVideo = { size: parseWindowSize(this.options.windowSize) };
+      // set the video resolution with window size
+      let size = parseWindowSize(this.options.windowSize);
+
+      // if the video resolution is passed, set the record resoultion with that resolution
+      if (this.options.recordVideo && this.options.recordVideo.size) {
+        size = parseWindowSize(this.options.recordVideo.size);
+      }
+      this.options.recordVideo = { size };
     }
     if (this.options.recordVideo && !this.options.recordVideo.dir) {
       this.options.recordVideo.dir = `${global.output_dir}/videos/`;
@@ -2984,7 +2991,7 @@ class Playwright extends Helper {
   }
 
   /**
-   * {{> flushNetworkTraffics }}
+   * {{> startRecordingTraffic }}
    *
    */
   startRecordingTraffic() {
@@ -3656,6 +3663,11 @@ async function targetCreatedHandler(page) {
 
 function parseWindowSize(windowSize) {
   if (!windowSize) return { width: 800, height: 600 };
+
+  if (windowSize.width && windowSize.height) {
+    return { width: parseInt(windowSize.width, 10), height: parseInt(windowSize.height, 10) };
+  }
+
   const dimensions = windowSize.split('x');
   if (dimensions.length < 2 || windowSize === 'maximize') {
     console.log('Invalid window size, setting window to default values');

package/lib/locator.js

@@ -541,7 +541,7 @@ function removePrefix(xpath) {
  * @returns {boolean}
  */
 function isPlaywrightLocator(locator) {
-  return locator.includes('_react') || locator.includes('_vue') || locator.includes('data-testid');
+  return locator.includes('_react') || locator.includes('_vue');
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.6.1",
+  "version": "3.6.2-beta.1",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -98,16 +98,16 @@
     "glob": "6.0.1",
     "html-minifier-terser": "7.2.0",
     "inquirer": "6.5.2",
-    "joi": "17.12.2",
+    "joi": "17.12.3",
     "js-beautify": "1.15.1",
     "lodash.clonedeep": "4.5.0",
     "lodash.merge": "4.6.2",
     "mkdirp": "1.0.4",
-    "mocha": "10.3.0",
+    "mocha": "10.4.0",
     "monocart-coverage-reports": "2.7.4",
     "ms": "2.1.3",
     "ora-classic": "5.4.2",
-    "pactum": "3.6.6",
+    "pactum": "3.6.7",
     "parse-function": "5.6.10",
     "parse5": "7.1.2",
     "promise-retry": "1.1.1",
@@ -148,7 +148,7 @@
     "jsdoc": "3.6.11",
     "jsdoc-typeof-plugin": "1.0.0",
     "json-server": "0.10.1",
-    "playwright": "1.43.0",
+    "playwright": "1.43.1",
     "puppeteer": "22.6.3",
     "qrcode-terminal": "0.12.0",
     "rosie": "2.1.1",
@@ -179,4 +179,4 @@
       "strict": false
     }
   }
-}
+}

package/typings/promiseBasedTypes.d.ts

@@ -1154,6 +1154,7 @@ declare namespace CodeceptJS {
      *
      * ## Methods
      */
+    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
@@ -1780,6 +1781,7 @@ declare namespace CodeceptJS {
      * @property [host = "0.0.0.0"] - Mock server host
      * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
      */
+    // @ts-ignore
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -1904,6 +1906,7 @@ declare namespace CodeceptJS {
      *
      * ## Methods
      */
+    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -4765,10 +4768,11 @@ declare namespace CodeceptJS {
          */
         stopMockingRoute(url?: string | RegExp, handler?: (...params: any[]) => any): Promise<any>;
         /**
-         * Resets all recorded network requests.
+         * Starts recording the network traffics.
+         * This also resets recorded network requests.
          *
          * ```js
-         * I.flushNetworkTraffics();
+         * I.startRecordingTraffic();
          * ```
          */
         startRecordingTraffic(): Promise<any>;

package/typings/types.d.ts

@@ -1178,6 +1178,7 @@ declare namespace CodeceptJS {
      *
      * ## Methods
      */
+    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
@@ -1807,6 +1808,7 @@ declare namespace CodeceptJS {
      * @property [host = "0.0.0.0"] - Mock server host
      * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
      */
+    // @ts-ignore
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -1931,6 +1933,7 @@ declare namespace CodeceptJS {
      *
      * ## Methods
      */
+    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -5015,11 +5018,13 @@ declare namespace CodeceptJS {
          */
         stopMockingRoute(url?: string | RegExp, handler?: (...params: any[]) => any): void;
         /**
-         * Resets all recorded network requests.
+         * Starts recording the network traffics.
+         * This also resets recorded network requests.
          *
          * ```js
-         * I.flushNetworkTraffics();
+         * I.startRecordingTraffic();
          * ```
+         * @returns automatically synchronized promise through #recorder
          */
         startRecordingTraffic(): void;
         /**
@@ -12377,14 +12382,14 @@ declare namespace CodeceptJS {
      * Detox provides a grey box testing for mobile applications, playing especially good for React Native apps.
      *
      * Detox plays quite differently from Appium. To establish detox testing you need to build a mobile application in a special way to inject Detox code.
-     * This why **Detox is grey box testing** solution, so you need an access to application source code, and a way to build and execute it on emulator.
+     * This why **Detox is grey box testing** solution, so you need access to application source code, and a way to build and execute it on emulator.
      *
      * Comparing to Appium, Detox runs faster and more stable but requires an additional setup for build.
      *
      * ### Setup
      *
-     * 1. [Install and configure Detox for iOS](https://github.com/wix/Detox/blob/master/docs/Introduction.GettingStarted.md) and [Android](https://github.com/wix/Detox/blob/master/docs/Introduction.Android.md)
-     * 2. [Build an application](https://github.com/wix/Detox/blob/master/docs/Introduction.GettingStarted.md#step-4-build-your-app-and-run-detox-tests) using `detox build` command.
+     * 1. [Install and configure Detox](https://wix.github.io/Detox/docs/introduction/project-setup)
+     * 2. [Build an application](https://wix.github.io/Detox/docs/introduction/project-setup#step-5-build-the-app) using `detox build` command.
      * 3. Install [CodeceptJS](https://codecept.io) and detox-helper:
      *
      * ```
@@ -12397,15 +12402,28 @@ declare namespace CodeceptJS {
      *
      * ```js
      *  "detox": {
-     *    "configurations": {
-     *      "ios.sim.debug": {
-     *        "binaryPath": "ios/build/Build/Products/Debug-iphonesimulator/example.app",
-     *        "build": "xcodebuild -project ios/example.xcodeproj -scheme example -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build",
-     *        "type": "ios.simulator",
-     *        "name": "iPhone 7"
-     *      }
-     *    }
-     *  }
+     *     "configurations": {
+     *       "ios.sim.debug": {
+     *         "device": "simulator",
+     *         "app": "ios.debug"
+     *       }
+     *     },
+     *     "apps": {
+     *       "ios.debug": {
+     *         "type": "ios.app",
+     *         "binaryPath": "../test/ios/build/Build/Products/Debug-iphonesimulator/MyTestApp.app",
+     *         "build": "xcodebuild -workspace ../test/ios/MyTestApp.xcworkspace -scheme MyTestApp -configuration Debug -sdk iphonesimulator -derivedDataPath ../test/ios/build"
+     *       }
+     *     },
+     *     "devices": {
+     *       "simulator": {
+     *         "type": "ios.simulator",
+     *         "device": {
+     *           "type": "iPhone 15"
+     *         }
+     *       }
+     *     }
+     *   }
      * ```
      *
      *
@@ -12500,6 +12518,14 @@ declare namespace CodeceptJS {
          * ```
          */
         setPortraitOrientation(): void;
+        /**
+         * Grab the device platform
+         *
+         * ```js
+         * const platform = await I.grabPlatform();
+         * ```
+         */
+        grabPlatform(): void;
         /**
          * Execute code only on iOS
          *
@@ -12589,6 +12615,19 @@ declare namespace CodeceptJS {
          * ```
          */
         click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
+        /**
+         * Clicks on an element.
+         * Element can be located by its label
+         *
+         * The second parameter is a context (id | type | accessibility id) to narrow the search.
+         *
+         *
+         * ```js
+         * I.tapByLabel('Login'); // locate by text
+         * I.tapByLabel('Login', '#nav'); // locate by text inside #nav
+         * ```
+         */
+        tapByLabel(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Performs click on element with horizontal and vertical offset.
          * An element is located by text, id, accessibility id.
@@ -12639,6 +12678,17 @@ declare namespace CodeceptJS {
          * @param [context = null] - context element
          */
         seeElement(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
+        /**
+         * Checks if an element exists.
+         *
+         * ```js
+         * I.checkIfElementExists('~edit'); // located by accessibility id
+         * I.checkIfElementExists('~edit', '#menu'); // element inside #menu
+         * ```
+         * @param locator - element to locate
+         * @param [context = null] - context element
+         */
+        checkIfElementExists(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString | null): void;
         /**
          * Checks that element is not visible.
          * Use second parameter to narrow down the search.
@@ -12688,6 +12738,18 @@ declare namespace CodeceptJS {
          * @param value - value to fill
          */
         fillField(field: CodeceptJS.LocatorOrString, value: string): void;
+        /**
+         * Taps return key.
+         * A field can be located by text, accessibility id, id.
+         *
+         * ```js
+         * I.tapReturnKey('Username');
+         * I.tapReturnKey('~name');
+         * I.tapReturnKey({ android: 'NAME', ios: 'name' });
+         * ```
+         * @param field - an input element to fill in
+         */
+        tapReturnKey(field: CodeceptJS.LocatorOrString): void;
         /**
          * Clears a text field.
          * A field can be located by text, accessibility id, id.
@@ -12813,7 +12875,7 @@ declare namespace CodeceptJS {
          */
         waitForElementVisible(locator: CodeceptJS.LocatorOrString, sec?: number): void;
         /**
-         * Waits an elment to become not visible.
+         * Waits an elmenet to become not visible.
          *
          * ```js
          * I.waitToHide('#message', 2); // wait for 2 seconds
@@ -12822,6 +12884,14 @@ declare namespace CodeceptJS {
          * @param [sec = 5] - number of seconds to wait
          */
         waitToHide(locator: CodeceptJS.LocatorOrString, sec?: number): void;
+        /**
+         * Scrolls within a scrollable container to an element.
+         * @param targetLocator - Locator of the element to scroll to
+         * @param containerLocator - Locator of the scrollable container
+         * @param direction - 'up' or 'down'
+         * @param [offset = 100] - Offset for scroll, can be adjusted based on need
+         */
+        scrollToElement(targetLocator: CodeceptJS.LocatorOrString, containerLocator: CodeceptJS.LocatorOrString, direction?: string, offset?: number): void;
     }
     /**
      * Abstract class.