codeceptjs 4.2.1 → 4.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.2.1",
+  "version": "4.2.2",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
@@ -59,39 +59,37 @@
     "mock-server:stop": "kill -9 $(lsof -t -i:3001)",
     "test:with-mock-server": "npm run mock-server:start && npm test",
     "json-server:graphql": "node test/data/graphql/index.js",
-    "lint": "eslint bin/ examples/ lib/ test/ translations/ runok.cjs",
-    "lint-fix": "eslint bin/ examples/ lib/ test/ translations/ runok.cjs --fix",
-    "prettier": "prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js runok.cjs",
-    "docs": "./runok.cjs docs",
-    "test:unit": "mocha test/unit --recursive --timeout 10000 --reporter @testomatio/reporter/mocha",
-    "test:unit:windows": "mocha test/unit/container_test.js --recursive --timeout 10000 --reporter @testomatio/reporter/mocha",
-    "test:rest": "mocha test/rest --recursive --timeout 20000 --reporter @testomatio/reporter/mocha",
-    "test:runner": "mocha test/runner --recursive --timeout 10000 --reporter @testomatio/reporter/mocha",
+    "lint": "eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js",
+    "lint-fix": "eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js --fix",
+    "prettier": "prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js Bunoshfile.js",
+    "docs": "bunosh docs",
+    "test:unit": "mocha test/unit --recursive --timeout 10000",
+    "test:unit:windows": "mocha test/unit/container_test.js --recursive --timeout 10000",
+    "test:rest": "mocha test/rest --recursive --timeout 20000",
+    "test:runner": "mocha test/runner --recursive --timeout 10000",
     "test": "npm run test:unit && npm run test:rest && npm run test:runner",
-    "test:appium-quick": "mocha test/helper/Appium_test.js --grep 'quick' --reporter @testomatio/reporter/mocha",
-    "test:appium-other": "mocha test/helper/Appium_test.js --grep 'second' --reporter @testomatio/reporter/mocha",
-    "test:ios:appium-quick": "mocha test/helper/Appium_ios_test.js --grep 'quick' --reporter @testomatio/reporter/mocha",
-    "test:ios:appium-other": "mocha test/helper/Appium_ios_test.js --grep 'second' --reporter @testomatio/reporter/mocha",
+    "test:appium-quick": "mocha test/helper/Appium_test.js --grep 'quick'",
+    "test:appium-other": "mocha test/helper/Appium_test.js --grep 'second'",
+    "test:ios:appium-quick": "mocha test/helper/Appium_ios_test.js --grep 'quick'",
+    "test:ios:appium-other": "mocha test/helper/Appium_ios_test.js --grep 'second'",
     "test-app:start": "php -S 127.0.0.1:8000 -t test/data/app",
     "test-app:stop": "kill -9 $(lsof -t -i:8000)",
-    "test:unit:webbapi:playwright": "mocha test/helper/Playwright_test.js --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:puppeteer": "mocha test/helper/Puppeteer_test.js --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:webDriver": "mocha test/helper/WebDriver_test.js --timeout 10000 --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:webDriver:noSeleniumServer": "mocha test/helper/WebDriver.noSeleniumServer_test.js --timeout 10000 --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:cdpbrowser": "mocha test/helper/CDPBrowser_chrome_test.js --timeout 30000 --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:obscura": "mocha test/helper/CDPBrowser_obscura_test.js --timeout 30000 --reporter @testomatio/reporter/mocha",
-    "test:unit:webbapi:lightpanda": "mocha test/helper/CDPBrowser_lightpanda_test.js --timeout 30000 --reporter @testomatio/reporter/mocha",
-    "test:unit:expect": "mocha test/helper/Expect_test.js --reporter @testomatio/reporter/mocha",
-    "test:plugin": "mocha test/plugin/plugin_test.js --reporter @testomatio/reporter/mocha",
-    "def": "./runok.cjs def",
+    "test:unit:webbapi:playwright": "mocha test/helper/Playwright_test.js",
+    "test:unit:webbapi:puppeteer": "mocha test/helper/Puppeteer_test.js",
+    "test:unit:webbapi:webDriver": "mocha test/helper/WebDriver_test.js --timeout 10000",
+    "test:unit:webbapi:webDriver:noSeleniumServer": "mocha test/helper/WebDriver.noSeleniumServer_test.js --timeout 10000",
+    "test:unit:webbapi:cdpbrowser": "mocha test/helper/CDPBrowser_chrome_test.js --timeout 30000",
+    "test:unit:webbapi:obscura": "mocha test/helper/CDPBrowser_obscura_test.js --timeout 30000",
+    "test:unit:webbapi:lightpanda": "mocha test/helper/CDPBrowser_lightpanda_test.js --timeout 30000",
+    "test:unit:webbapi:moli": "mocha test/helper/CDPBrowser_moli_test.js --timeout 30000",
+    "test:unit:expect": "mocha test/helper/Expect_test.js",
+    "test:plugin": "mocha test/plugin/plugin_test.js",
+    "def": "bunosh def",
     "dev:graphql": "node test/data/graphql/index.js",
-    "publish:site": "./runok.cjs publish:site",
-    "update-contributor-faces": "./runok.cjs contributor:faces",
+    "update-contributor-faces": "bunosh contributor:faces",
     "types-fix": "node typings/fixDefFiles.js",
     "dtslint": "npm run types-fix && tsd",
-    "prepare": "husky install",
-    "prepare-release": "./runok.cjs versioning && ./runok.cjs get:commit-log",
-    "publish-beta": "./runok.cjs publish:next-beta-version"
+    "prepare": "husky install"
   },
   "dependencies": {
     "@codeceptjs/configure": "^4.0.0-beta.4",
@@ -100,11 +98,11 @@
     "@cucumber/gherkin": "38.0.0",
     "@cucumber/messages": "32.3.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@xmldom/xmldom": "0.9.10",
+    "@xmldom/xmldom": "^0.9.12",
     "acorn": "8.15.0",
     "ai": "7.0.132",
     "arrify": "3.0.0",
-    "axios": "1.16.1",
+    "axios": "^1.20.0",
     "chalk": "4.1.2",
     "cheerio": "^1.0.0",
     "chokidar": "^5.0.0",
@@ -127,7 +125,7 @@
     "lodash.merge": "4.6.2",
     "lodash.shuffle": "4.2.0",
     "mkdirp": "3.0.1",
-    "mocha": "11.7.5",
+    "mocha": "^12.0.3",
     "monocart-coverage-reports": "2.12.12",
     "ms": "2.1.3",
     "multer": "^2.0.2",
@@ -160,8 +158,8 @@
     "@wdio/sauce-service": "9.12.5",
     "@wdio/selenium-standalone-service": "8.15.0",
     "@wdio/utils": "9.23.3",
-    "@xmldom/xmldom": "0.9.10",
-    "bunosh": "latest",
+    "@xmldom/xmldom": "^0.9.12",
+    "bunosh": "^0.6.0",
     "chai": "^6.2.1",
     "chai-as-promised": "^8.0.2",
     "chai-subset": "1.6.0",
@@ -184,7 +182,6 @@
     "puppeteer": "24.36.0",
     "qrcode-terminal": "0.12.0",
     "rosie": "2.1.1",
-    "runok": "^0.9.3",
     "semver": "7.7.3",
     "sinon": "22.0.0",
     "sinon-chai": "^4.0.1",

package/typings/promiseBasedTypes.d.ts

@@ -3495,6 +3495,112 @@ declare namespace CodeceptJS {
     class LightpandaTs {
         constructor(config: LightpandaConfig);
     }
+    /**
+     * ## Configuration
+     *
+     * This helper should be configured in codecept.conf.js
+     * @property [endpoint] - explicit CDP endpoint. Setting this switches the helper to ATTACH
+     * mode: it only connects, and never spawns or kills a process, no matter what else is configured.
+     * Leave it unset for SELF-MANAGED mode (see below).
+     * @property [binaryPath] - path to the `moli` executable, used in SELF-MANAGED mode
+     * (`endpoint` unset). Checked before `MOLI_PATH` and `PATH`.
+     * @property [port] - port `moli serve` listens on, in SELF-MANAGED mode. When unset, a free
+     * port is picked automatically, which is what makes `run-workers` collision-free — every worker
+     * gets its own instance on its own port with zero config.
+     * @property [serverStartTimeout = 15000] - milliseconds to wait for a spawned `moli serve` to
+     * answer `/json/version` before `_connect` gives up.
+     */
+    type MoliConfig = {
+        endpoint?: string;
+        binaryPath?: string;
+        port?: number;
+        serverStartTimeout?: number;
+    };
+    /**
+     * Moli drives [Moli](https://github.com/lexmount/moli), an open-source headless browser written
+     * in Rust for automation, exposed over the Chrome DevTools Protocol. It runs real JavaScript in V8
+     * and computes styles with Servo's Stylo, but by default skips layout and painting: element boxes
+     * use deterministic placeholder geometry, so there are no screenshots and no coordinate input.
+     *
+     * This helper is a thin `CDPBrowser` subclass: it changes nothing about how locating or acting on
+     * elements works, it only pins the config presets Moli requires and manages the `moli serve`
+     * process lifecycle, the same way Playwright manages its own browser process.
+     *
+     * > Moli support is experimental. Pin the browser version in CI and keep a
+     * > Playwright/WebDriver job for browser-compatibility coverage.
+     *
+     * ## Modes
+     *
+     * - **ATTACH** — `endpoint` is set explicitly in the config. The helper only connects to it; it
+     *   never spawns or kills anything, no matter what `binaryPath`/`port` are set to.
+     * - **SELF-LAUNCH** — `endpoint` is unset and a binary can be resolved, in order: `binaryPath` in
+     *   the config, then the `MOLI_PATH` environment variable, then `moli` on `PATH`. The helper
+     *   spawns `moli serve --host 127.0.0.1 --port <port>` (`port` from the config, or a free port
+     *   picked automatically), waits for it to answer, connects, and kills it in `_finishTest`.
+     * - **COURTESY-ATTACH** — `endpoint` is unset and no binary can be resolved, but something already
+     *   answers `http://127.0.0.1:9222/json/version` (e.g. `moli serve` started by hand). The helper
+     *   attaches to it and never kills it. If neither a binary nor a running server on :9222 can be
+     *   found, the helper throws a loud, actionable error.
+     *
+     * ## Install
+     *
+     * Follow the [official installation instructions](https://github.com/lexmount/moli#direct-installation),
+     * then put `moli` on your `PATH`, or point `binaryPath`/`MOLI_PATH` at it. The helper then
+     * launches and tears it down automatically.
+     *
+     * ## Config presets
+     *
+     * These are set automatically and only need overriding for unusual setups:
+     *
+     * | option | value | why |
+     * | --- | --- | --- |
+     * | `input` | `synthetic` | without layout Moli rejects coordinate mouse input, so `click` always takes the `forceClick` path |
+     * | `xpathPolyfill` | `auto` | probed per binary/page |
+     * | `capabilities.layout` | `real` | Moli computes real styles and gives displayed elements a non-empty placeholder box, which is enough for `seeElement` and the `waitForVisible` family; it is pinned because the runtime probe would also enable coordinate input |
+     * | `capabilities.screenshot` | `false` | screenshots require `moli serve --layout`, which this helper does not use: its layout is a snapshot that goes stale when the page changes |
+     *
+     * ## Limitations
+     *
+     * - No screenshots and no screencast: `saveScreenshot` and `saveElementScreenshot` do nothing (a debug message is printed).
+     * - No coordinate-based input (`clickXY`).
+     * - No frames or popups.
+     * - Uploaded files are sent as `application/octet-stream` regardless of their extension.
+     * - The default stylesheet does not color links: `a` computes `color: rgb(0, 0, 0)`.
+     *
+     * <!-- configuration -->
+     *
+     * ## Example
+     *
+     * ```js
+     * // inside codecept.conf.js — SELF-LAUNCH mode (recommended): the helper finds/starts/stops
+     * // moli serve on its own, on a free port. Ideal for run-workers: every worker gets its own
+     * // instance with no config.
+     * {
+     *   helpers: {
+     *     Moli: {
+     *       url: 'http://localhost',
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * ```js
+     * // ATTACH mode — connect to a Moli instance you manage yourself (remote host, container, etc.)
+     * {
+     *   helpers: {
+     *     Moli: {
+     *       url: 'http://localhost',
+     *       endpoint: 'http://127.0.0.1:9222',
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * ## Methods
+     */
+    class MoliTs {
+        constructor(config: MoliConfig);
+    }
     /**
      * ## Configuration
      *

package/typings/types.d.ts

@@ -3598,6 +3598,112 @@ declare namespace CodeceptJS {
     class Lightpanda {
         constructor(config: LightpandaConfig);
     }
+    /**
+     * ## Configuration
+     *
+     * This helper should be configured in codecept.conf.js
+     * @property [endpoint] - explicit CDP endpoint. Setting this switches the helper to ATTACH
+     * mode: it only connects, and never spawns or kills a process, no matter what else is configured.
+     * Leave it unset for SELF-MANAGED mode (see below).
+     * @property [binaryPath] - path to the `moli` executable, used in SELF-MANAGED mode
+     * (`endpoint` unset). Checked before `MOLI_PATH` and `PATH`.
+     * @property [port] - port `moli serve` listens on, in SELF-MANAGED mode. When unset, a free
+     * port is picked automatically, which is what makes `run-workers` collision-free — every worker
+     * gets its own instance on its own port with zero config.
+     * @property [serverStartTimeout = 15000] - milliseconds to wait for a spawned `moli serve` to
+     * answer `/json/version` before `_connect` gives up.
+     */
+    type MoliConfig = {
+        endpoint?: string;
+        binaryPath?: string;
+        port?: number;
+        serverStartTimeout?: number;
+    };
+    /**
+     * Moli drives [Moli](https://github.com/lexmount/moli), an open-source headless browser written
+     * in Rust for automation, exposed over the Chrome DevTools Protocol. It runs real JavaScript in V8
+     * and computes styles with Servo's Stylo, but by default skips layout and painting: element boxes
+     * use deterministic placeholder geometry, so there are no screenshots and no coordinate input.
+     *
+     * This helper is a thin `CDPBrowser` subclass: it changes nothing about how locating or acting on
+     * elements works, it only pins the config presets Moli requires and manages the `moli serve`
+     * process lifecycle, the same way Playwright manages its own browser process.
+     *
+     * > Moli support is experimental. Pin the browser version in CI and keep a
+     * > Playwright/WebDriver job for browser-compatibility coverage.
+     *
+     * ## Modes
+     *
+     * - **ATTACH** — `endpoint` is set explicitly in the config. The helper only connects to it; it
+     *   never spawns or kills anything, no matter what `binaryPath`/`port` are set to.
+     * - **SELF-LAUNCH** — `endpoint` is unset and a binary can be resolved, in order: `binaryPath` in
+     *   the config, then the `MOLI_PATH` environment variable, then `moli` on `PATH`. The helper
+     *   spawns `moli serve --host 127.0.0.1 --port <port>` (`port` from the config, or a free port
+     *   picked automatically), waits for it to answer, connects, and kills it in `_finishTest`.
+     * - **COURTESY-ATTACH** — `endpoint` is unset and no binary can be resolved, but something already
+     *   answers `http://127.0.0.1:9222/json/version` (e.g. `moli serve` started by hand). The helper
+     *   attaches to it and never kills it. If neither a binary nor a running server on :9222 can be
+     *   found, the helper throws a loud, actionable error.
+     *
+     * ## Install
+     *
+     * Follow the [official installation instructions](https://github.com/lexmount/moli#direct-installation),
+     * then put `moli` on your `PATH`, or point `binaryPath`/`MOLI_PATH` at it. The helper then
+     * launches and tears it down automatically.
+     *
+     * ## Config presets
+     *
+     * These are set automatically and only need overriding for unusual setups:
+     *
+     * | option | value | why |
+     * | --- | --- | --- |
+     * | `input` | `synthetic` | without layout Moli rejects coordinate mouse input, so `click` always takes the `forceClick` path |
+     * | `xpathPolyfill` | `auto` | probed per binary/page |
+     * | `capabilities.layout` | `real` | Moli computes real styles and gives displayed elements a non-empty placeholder box, which is enough for `seeElement` and the `waitForVisible` family; it is pinned because the runtime probe would also enable coordinate input |
+     * | `capabilities.screenshot` | `false` | screenshots require `moli serve --layout`, which this helper does not use: its layout is a snapshot that goes stale when the page changes |
+     *
+     * ## Limitations
+     *
+     * - No screenshots and no screencast: `saveScreenshot` and `saveElementScreenshot` do nothing (a debug message is printed).
+     * - No coordinate-based input (`clickXY`).
+     * - No frames or popups.
+     * - Uploaded files are sent as `application/octet-stream` regardless of their extension.
+     * - The default stylesheet does not color links: `a` computes `color: rgb(0, 0, 0)`.
+     *
+     * <!-- configuration -->
+     *
+     * ## Example
+     *
+     * ```js
+     * // inside codecept.conf.js — SELF-LAUNCH mode (recommended): the helper finds/starts/stops
+     * // moli serve on its own, on a free port. Ideal for run-workers: every worker gets its own
+     * // instance with no config.
+     * {
+     *   helpers: {
+     *     Moli: {
+     *       url: 'http://localhost',
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * ```js
+     * // ATTACH mode — connect to a Moli instance you manage yourself (remote host, container, etc.)
+     * {
+     *   helpers: {
+     *     Moli: {
+     *       url: 'http://localhost',
+     *       endpoint: 'http://127.0.0.1:9222',
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * ## Methods
+     */
+    class Moli {
+        constructor(config: MoliConfig);
+    }
     /**
      * ## Configuration
      *