Skip to content

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

Section titled “Configuration”
"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

Section titled “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

Section titled “Parameters”
  • config any