codeceptjs 3.7.4 → 3.7.5-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.7.4",
+  "version": "3.7.5-beta.10",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -42,7 +42,7 @@
   },
   "repository": "Codeception/codeceptjs",
   "scripts": {
-    "json-server": "json-server test/data/rest/db.json --host 0.0.0.0 -p 8010 --watch -m test/data/rest/headers.js",
+    "test-server": "node bin/test-server.js test/data/rest/db.json --host 0.0.0.0 -p 8010",
     "json-server:graphql": "node test/data/graphql/index.js",
     "lint": "eslint bin/ examples/ lib/ test/ translations/ runok.js",
     "lint-fix": "eslint bin/ examples/ lib/ test/ translations/ runok.js --fix",
@@ -86,6 +86,7 @@
     "axios": "1.11.0",
     "chalk": "4.1.2",
     "cheerio": "^1.0.0",
+    "chokidar": "^4.0.3",
     "commander": "11.1.0",
     "cross-spawn": "7.0.6",
     "css-to-xpath": "0.1.0",
@@ -98,17 +99,18 @@
     "fuse.js": "^7.0.0",
     "glob": ">=9.0.0 <12",
     "html-minifier-terser": "7.2.0",
-    "inquirer": "8.2.6",
+    "inquirer": "^8.2.7",
     "invisi-data": "^1.0.0",
     "joi": "17.13.3",
     "js-beautify": "1.15.4",
     "lodash.clonedeep": "4.5.0",
-    "lodash.shuffle": "4.2.0",
     "lodash.merge": "4.6.2",
+    "lodash.shuffle": "4.2.0",
     "mkdirp": "3.0.1",
     "mocha": "11.6.0",
     "monocart-coverage-reports": "2.12.6",
     "ms": "2.1.3",
+    "multer": "^2.0.2",
     "ora-classic": "5.4.2",
     "parse-function": "5.6.10",
     "parse5": "7.3.0",
@@ -125,7 +127,7 @@
     "@codeceptjs/expect-helper": "^1.0.2",
     "@codeceptjs/mock-request": "0.3.1",
     "@eslint/eslintrc": "3.3.1",
-    "@eslint/js": "9.31.0",
+    "@eslint/js": "9.34.0",
     "@faker-js/faker": "9.8.0",
     "@pollyjs/adapter-puppeteer": "6.0.6",
     "@pollyjs/core": "6.0.6",
@@ -145,7 +147,7 @@
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-mocha": "11.1.0",
     "expect": "30.0.5",
-    "express": "5.1.0",
+    "express": "^5.1.0",
     "globals": "16.2.0",
     "graphql": "16.11.0",
     "graphql-tag": "^2.12.6",

package/typings/index.d.ts

@@ -440,7 +440,7 @@ declare namespace CodeceptJS {
   interface IHook {}
   interface IScenario {}
   interface IFeature {
-    (title: string): FeatureConfig
+    (title: string, opts?: { [key: string]: any }): FeatureConfig
   }
   interface CallbackOrder extends Array<any> {}
   interface SupportObject {
@@ -486,6 +486,7 @@ declare namespace CodeceptJS {
     todo: IScenario
   }
   interface Feature extends IFeature {
+    only: IFeature
     skip: IFeature
   }
   interface IData {
@@ -519,11 +520,17 @@ declare namespace CodeceptJS {
   }
 }
 
+type TryTo = <T>(fn: () => Promise<T> | T) => Promise<T | false>;
+type HopeThat = <T>(fn: () => Promise<T> | T) => Promise<T | false>;
+type RetryTo = <T>(fn: () => Promise<T> | T, retries?: number) => Promise<T>;
+
+
 // Globals
 declare const codecept_dir: string
 declare const output_dir: string
-declare function tryTo(...fn): Promise<boolean>
-declare function retryTo(...fn): Promise<null>
+declare const tryTo: TryTo;
+declare const retryTo: RetryTo;
+declare const hopeThat: HopeThat;
 
 declare const actor: CodeceptJS.actor
 declare const codecept_actor: CodeceptJS.actor
@@ -545,7 +552,7 @@ declare const Given: typeof CodeceptJS.addStep
 declare const When: typeof CodeceptJS.addStep
 declare const Then: typeof CodeceptJS.addStep
 
-declare const Feature: typeof CodeceptJS.Feature
+declare const Feature: CodeceptJS.Feature
 declare const Scenario: CodeceptJS.Scenario
 declare const xScenario: CodeceptJS.IScenario
 declare const xFeature: CodeceptJS.IFeature
@@ -634,3 +641,9 @@ declare module 'codeceptjs' {
 declare module '@codeceptjs/helper' {
   export = CodeceptJS.Helper
 }
+
+declare module 'codeceptjs/effects' {
+  export const tryTo: TryTo;
+  export const retryTo: RetryTo;
+  export const hopeThat: HopeThat;
+}

package/typings/promiseBasedTypes.d.ts

@@ -2733,7 +2733,11 @@ declare namespace CodeceptJS {
      * @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).
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
+     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(\`[role="\${selector}\"]\`) } }`
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -2771,6 +2775,7 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
         recordHar?: any;
         testIdAttribute?: string;
+        customLocatorStrategies?: any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -6110,6 +6115,9 @@ declare namespace CodeceptJS {
      * @property [chrome] - pass additional [Puppeteer run options](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions).
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -7916,6 +7924,9 @@ declare namespace CodeceptJS {
      * @property [onResponse] - an async function which can update response object.
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9061,6 +9072,9 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [logLevel = silent] - level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: https://webdriver.io/docs/configuration/#loglevel
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;

package/typings/types.d.ts

@@ -2823,7 +2823,11 @@ declare namespace CodeceptJS {
      * @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).
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
+     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(\`[role="\${selector}\"]\`) } }`
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -2861,6 +2865,7 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
         recordHar?: any;
         testIdAttribute?: string;
+        customLocatorStrategies?: any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -6351,6 +6356,9 @@ declare namespace CodeceptJS {
      * @property [chrome] - pass additional [Puppeteer run options](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions).
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -8293,6 +8301,9 @@ declare namespace CodeceptJS {
      * @property [onResponse] - an async function which can update response object.
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9498,6 +9509,9 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [logLevel = silent] - level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: https://webdriver.io/docs/configuration/#loglevel
      */
+    // @ts-ignore
+    // @ts-ignore
+    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -12118,6 +12132,10 @@ declare namespace CodeceptJS {
     function Feature(title: string, opts?: {
         [key: string]: any;
     }): FeatureConfig;
+    /**
+     * Exclusive test suite - runs only this feature.
+     */
+    const only: CodeceptJS.IFeature;
     /**
      * Pending test suite.
      */