---
permalink: /plugins/aiTrace
editLink: false
sidebar: auto
title: aiTrace
---

<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

## aiTrace

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.

#### Configuration

```js
"plugins": {
   "aiTrace": {
     "enabled": true
   }
 }
```

Possible config options:

*   `deleteSuccessful`: delete traces for successfully executed tests. Default: false.
*   `fullPageScreenshots`: should full page screenshots be used. Default: false.
*   `output`: a directory where traces should be stored. Default: `output`.
*   `captureHTML`: capture HTML for each step. Default: true.
*   `captureARIA`: capture ARIA snapshot for each step. Default: true.
*   `captureBrowserLogs`: capture browser console logs. Default: true.
*   `captureHTTP`: capture HTTP requests (requires `trace` or `recordHar` enabled in helper config). Default: true.
*   `captureDebugOutput`: capture CodeceptJS debug output. Default: true.
*   `ignoreSteps`: steps to ignore in trace. Array of RegExps is expected.
*   `on`: trigger mode — `step` (default), `fail`, `test`, `file`, `url`.

#### `on=` modes

*   **step** — persist every step (default)
*   **fail** — persist only the failed step
*   **test** — persist only the last step of each test
*   **file** — persist steps from `path=...[;line=...]`
*   **url** — persist when the current URL matches `pattern=...`

### Parameters

*   `config` **any**