browser.traceView Experimental 5.0.0+
- Type:
boolean | { enabled?: boolean; recordCanvas?: boolean; inlineImages?: boolean } - CLI:
--browser.traceView - Default:
false
Enable trace view collection for browser tests. Vitest captures DOM snapshots for browser interactions and can show them in the browser UI, Vitest UI, or HTML reporter when those surfaces are enabled — no external tools required. When a test fails, the terminal output also includes a timeline of its recorded steps.
ts
export default defineConfig({
test: {
browser: {
traceView: true,
},
},
})Use the object form to enable additional snapshot fidelity options:
ts
export default defineConfig({
test: {
browser: {
traceView: {
enabled: true,
inlineImages: true,
recordCanvas: true,
},
},
},
})| Option | Default | Description |
|---|---|---|
enabled | false | Enables Vitest trace-view artifact collection. |
inlineImages | false | Inlines loaded <img> pixels into snapshots for more portable replay, useful in the HTML reporter. |
recordCanvas | false | Captures canvas pixels in snapshots. |
browser.traceView.enabled
- Type:
boolean - Default:
false - CLI:
--browser.traceView.enabled
Enables Vitest trace-view artifact collection.
browser.traceView.inlineImages
- Type:
boolean - Default:
false - CLI:
--browser.traceView.inlineImages
Inlines loaded <img> pixels into snapshots for more portable replay, useful in the HTML reporter.
browser.traceView.recordCanvas
- Type:
boolean - Default:
false - CLI:
--browser.traceView.recordCanvas
Captures canvas pixels in snapshots. This enables a weaker replay iframe sandbox because rrweb needs scripts to redraw canvas data.
See Trace View for full documentation.