codeceptjs 4.2.0-beta.4 → 4.2.1-beta.1

package/docs/commands.md

@@ -53,6 +53,14 @@ Run test files in shuffled order
 npx codeceptjs run --shuffle
 ```
 
+Rerun only tests that failed in the previous run
+
+```sh
+npx codeceptjs run --last-failed
+```
+
+See [Last Failed](#last-failed) for details.
+
 Run single test in debug mode (see more in [debugging](#Debugging) section)
 
 ```sh
@@ -157,6 +165,12 @@ npx codeceptjs run-workers 3 --by suite
 
 # Pool mode with filtering
 npx codeceptjs run-workers 4 --by pool --grep "@smoke"
+
+# Rerun only tests that failed in the previous run
+npx codeceptjs run-workers 3 --last-failed
+
+# Run tests tagged @serial one by one after parallel workers finish
+npx codeceptjs run-workers 3 --serial "@serial"
 ```
 
 **Test Distribution Strategies:**
@@ -165,10 +179,31 @@ npx codeceptjs run-workers 4 --by pool --grep "@smoke"
 - `--by suite`: Pre-assigns entire test suites to workers  
 - `--by pool`: Dynamic distribution for optimal load balancing (recommended for best performance)
 
+`--serial <pattern>` keeps tests matching the pattern out of parallel workers and runs them one by one in an extra worker once the others finish, within the same run. It overrides the `serial` config option. See [Serial tests](/parallel#serial-tests).
+
 The pool mode provides the best load balancing by maintaining tests in a shared pool and distributing them dynamically as workers become available. This prevents workers from sitting idle and ensures optimal CPU utilization, especially when tests have varying execution times.
 
 See [Parallel Execution](/parallel) documentation for more details.
 
+## Last Failed
+
+Rerun only the tests that failed in the previous run. Works with `run` and `run-workers`, including all `--by` strategies:
+
+```sh
+npx codeceptjs run --last-failed
+npx codeceptjs run-workers 3 --last-failed
+```
+
+Every `run` and `run-workers` writes a report to `result.json` in the output directory (`output` in config). It lists each executed test with its state. `--last-failed` reads this report and runs only the tests whose state is `failed`:
+
+- Skipped and pending tests are not considered failed.
+- Tests are matched by their title, including the Feature title. A renamed test or Feature is not matched.
+- Combined with `--grep`, only failed tests that also match the pattern are run.
+- The report always reflects the most recent run, including a `--last-failed` run. Tests that pass in a rerun drop out of the next `--last-failed` set; tests that did not run (filtered out by `--grep`, sharding, and so on) are not included.
+- If the report does not exist, the command fails with "No previous run found". If the last run had no failures, it prints "No failed tests in the last run" and exits with code 0.
+
+`--last-failed` is different from [run-rerun](#run-rerun), which repeats whole runs to detect flaky tests.
+
 ## Run Rerun <Badge text="Since 3.3.6" type="warning"/>
 
 Run tests multiple times to detect and fix flaky tests.
@@ -262,6 +297,16 @@ Or in provided path
 npx codecept init test
 ```
 
+## Init Agent
+
+Registers the CodeceptJS MCP server and installs CodeceptJS skills for a coding agent (`claude`, `codex`, `cursor`, `opencode`):
+
+```sh
+npx codeceptjs init:agent claude
+```
+
+Omit the agent to pick it from a list. See [Agentic Testing](/agents).
+
 ## Migrate
 
 Migrate your current `codecept.json` to `codecept.conf.js`

package/docs/configuration.md

@@ -39,11 +39,13 @@ export const config = {
 
 - `bootstrap` / `teardown` — run code before / after the whole run; an async function or a path to a JS module. See [Bootstrap](/bootstrap).
 - `bootstrapAll` / `teardownAll` — run once around a parallel run (before any worker starts / after all finish). See [bootstrapAll / teardownAll](/bootstrap#bootstrapall-teardownall).
+- `webServer` — start the application under test before the run and stop it after. See [Web Server](#web-server).
 
 **Test runner**
 
 - `timeout` — default per-test timeout in seconds; a test is killed if it stops responding.
 - `mocha` — [Mocha options](https://mochajs.org/#configuring-mocha-nodejs), including extra reporters. See [Reporters](/reports).
+- `serial` — pattern for tests that must not run in parallel, e.g. `serial: '@serial'`. With `run-workers` they run one by one after all parallel workers finish. `--serial` overrides it. See [Serial tests](/parallel#serial-tests).
 - `workerInitializationDelay` — delay in milliseconds between spinning up parallel workers to prevent CPU spikes and stagger browser startup. Defaults to `200`. Set to `0` to disable.
 - `workerInitializationMaxDelay` — maximum total delay (in milliseconds) for worker initialization staggering. Defaults to `10000` (10 s). Set to `0` to disable capping.
 
@@ -89,6 +91,41 @@ require: ['tsx/esm', 'should', './lib/testSetup']
 
 The config file itself (`codecept.conf.ts`) and helpers are transpiled automatically — only test files need the loader. See [TypeScript](/typescript) for the full setup.
 
+## Web Server
+
+`webServer` starts your application before tests run and stops it when they finish, so you don't need a `bootstrap` script for it:
+
+```js
+export const config = {
+  webServer: {
+    command: 'npm run start',
+    url: 'http://localhost:3000',
+    enabled: !process.env.CI,
+  },
+  // ...
+}
+```
+
+- `command` — shell command that starts the app.
+- `url` — CodeceptJS sends GET requests here until it gets any HTTP response, then starts the tests. If `url` already responds before `command` is run, the running server is reused.
+- `enabled` — set to `false` to skip starting the server, e.g. `enabled: !process.env.CI` when CI provides its own. Default `true`.
+- `timeout` — milliseconds to wait for `url`. Default `60000`.
+- `cwd` — working directory for `command`, relative to the config file. Default is the config directory.
+- `env` — extra environment variables for `command`.
+
+If the server exits early or doesn't respond within `timeout`, the run fails and prints the last 20 lines of its output. Run with `--debug` to see all of its output.
+
+To start several services, pass an array. They start in order and stop in reverse order:
+
+```js
+webServer: [
+  { command: 'npm run api', url: 'http://localhost:4000/health' },
+  { command: 'npm run start', url: 'http://localhost:3000' },
+],
+```
+
+The server is started as part of bootstrap, right before the `bootstrap` hook (or `bootstrapAll` for `run-workers` and `run-multiple`), and stopped after `teardown` (`teardownAll`). It starts once in the main process; workers and child processes reuse it. The interactive `shell` starts it too, `dry-run` and `check` only with `--bootstrap`. CodeceptJS stops the command and every process it spawned, including when the run is interrupted with Ctrl+C.
+
 ## Dynamic configuration
 
 A JS/TS config file is plain code, so you can read environment variables and build the config at runtime:

package/docs/debugging.md

@@ -120,7 +120,7 @@ For automated debugging without modifying test code, use the `pause` plugin. It
 
 ### Pause on Failure
 
-Automatically enters interactive pause when a step fails:
+Automatically enters interactive pause when a step fails. Failures inside `tryTo` and `retryTo` attempts that will be retried are ignored:
 
 ```bash
 npx codeceptjs run -p pause

package/docs/helpers/ApiDataFactory.md

@@ -192,26 +192,6 @@ By default `id` property of response is taken. This behavior can be changed by s
 
 *   `config`  
 
-### _requestCreate
-
-Executes request to create a record in API.
-Can be replaced from a in custom helper.
-
-#### Parameters
-
-*   `factory` **any** 
-*   `data` **any** 
-
-### _requestDelete
-
-Executes request to delete a record in API
-Can be replaced from a custom helper.
-
-#### Parameters
-
-*   `factory` **any** 
-*   `id` **any** 
-
 ### have
 
 Generates a new record using factory and saves API request to store it.
@@ -256,6 +236,26 @@ I.haveMultiple('post', 3, { author: 'davert' }, { publish_date: '01.01.1997' });
 *   `params` **any?** 
 *   `options` **any?** 
 
+### _requestCreate
+
+Executes request to create a record in API.
+Can be replaced from a in custom helper.
+
+#### Parameters
+
+*   `factory` **any** 
+*   `data` **any** 
+
+### _requestDelete
+
+Executes request to delete a record in API
+Can be replaced from a custom helper.
+
+#### Parameters
+
+*   `factory` **any** 
+*   `id` **any** 
+
 [1]: https://github.com/rosiejs/rosie
 
 [2]: https://www.npmjs.com/package/faker