docs/plugins.md
CodeceptJS bundles the following plugins. Each plugin has its own page with full configuration reference.
Pauses test execution interactively. Replaces the legacy pauseOnFail plugin. The default on=fail matches the old pauseOnFail behavior.
Collects information from web page after each failed test and adds it to the test as an artifact. It is suggested to enable this plugin if you run tests on CI and you need to debug failed tests. This plugin can be paired with analyze plugin to provide more context.
Exposes properties from helper instances as injectable test arguments. Use it to access the underlying Playwright/Puppeteer page, the wdio browser client, or any other helper internal directly from a Scenario:
Generates a JUnit-compatible XML report after a test run.
Dumps code coverage from Playwright/Puppeteer after every test.
Saves screenshots from the browser at points triggered by on=.
Records WebM video of tests using Playwright's screencast API.
Creates a [custom locator][1] by using special attributes in HTML.
Generates AI-friendly trace files for debugging with AI agents. This plugin creates a markdown file with test execution logs and links to all artifacts (screenshots, HTML, ARIA snapshots, browser logs, HTTP requests) for each step.
Logs user in for the first test and reuses session for next tests. Works by saving cookies into memory or file. If a session expires automatically logs in again.
Starts an interactive pause when a test fails.
Uses AI to analyze test failures and provide insights
Sometimes it takes some time for a page to respond to user's actions. Depending on app's performance this can be either slow or fast.
Set timeout for test steps globally.
Self-healing tests with AI.
Sample custom reporter for CodeceptJS.
Saves a screenshot when a test fails.
Retries each failed step in a test.
Overrides browser helper config from the command line. Works for all browser helpers (Playwright, Puppeteer, WebDriver, Appium) without touching codecept.conf.