playwright-trace

# Extract trace and show metadata: browser, viewport, duration, action/error counts
npx playwright trace open <trace.zip>

# Remove extracted trace data
npx playwright trace close

# List all actions as a tree with action IDs and timing
npx playwright trace actions
 
# Filter by action title (regex, case-insensitive)
npx playwright trace actions --grep "click"
 
# Only failed actions
npx playwright trace actions --errors-only

# Show full details for one action: params, result, logs, source, snapshots
npx playwright trace action <action-id>

# All network requests: start time (on the `trace actions` clock), method, status, URL, duration, size
npx playwright trace requests
 
# Filter by URL pattern
npx playwright trace requests --grep "api"
 
# Filter by HTTP method
npx playwright trace requests --method POST
 
# Only failed requests (status >= 400)
npx playwright trace requests --failed

# Show full details for one request: headers, body, security
npx playwright trace request <request-id>

# All console messages and stdout/stderr
npx playwright trace console
 
# Only errors
npx playwright trace console --errors-only
 
# Only browser console (no stdout/stderr)
npx playwright trace console --browser
 
# Only stdout/stderr (no browser console)
npx playwright trace console --stdio
 
# Filter by message text pattern
npx playwright trace console --grep "failed to fetch"

# All errors with stack traces and associated actions
npx playwright trace errors

# Get the accessibility snapshot (default)
npx playwright trace snapshot <action-id>
 
# Use a specific phase
npx playwright trace snapshot <action-id> --phase before
 
# Run eval to query the DOM
npx playwright trace snapshot <action-id> -- eval "document.title"
npx playwright trace snapshot <action-id> -- eval "document.querySelector('#error').textContent"
 
# Eval on a specific element ref (from the snapshot)
npx playwright trace snapshot <action-id> -- eval "el => el.getAttribute('data-testid')" e5
 
# Take a screenshot of the snapshot
npx playwright trace snapshot <action-id> -- screenshot
 
# Redirect output to a file
npx playwright trace snapshot <action-id> -- eval "document.body.outerHTML" --filename=page.html
npx playwright trace snapshot <action-id> -- screenshot --filename=screenshot.png

# List all trace attachments
npx playwright trace attachments
 
# Extract an attachment by its number
npx playwright trace attachment 1
npx playwright trace attachment 1 -o out.png

# 1. Open the trace and see what's inside
npx playwright trace open test-results/my-test/trace.zip
 
# 2. What actions ran?
npx playwright trace actions
 
# 3. Which action failed?
npx playwright trace actions --errors-only
 
# 4. What went wrong?
npx playwright trace action 12
 
# 5. What did the page look like at that moment?
npx playwright trace snapshot 12
 
# 6. Query the DOM for more detail
npx playwright trace snapshot 12 -- eval "document.querySelector('.error-message').textContent"
 
# 7. Any relevant network failures?
npx playwright trace requests --failed
 
# 8. Any console errors?
npx playwright trace console --errors-only