Umbra Reporter

Playwright test reporter with a rich UI dashboard and built-in trace viewer.

Features

• Self-contained HTML report — single file, no server required to open
• Rich test details — error message, stack trace, step tree, stdout/stderr
• Retry tabs — per-attempt error, steps, and output for every retry
• Built-in trace viewer — open Playwright traces directly in the browser via umbra-serve
• Multi-project support — group tests by file or by title across projects
• Three-state filters — include / exclude by status, tag, or project
• Search — filter by test title or file path
• Similar failures — shows other tests with the same error at a glance
• Annotations — displays test annotations with optional Jira status enrichment
• Dark theme UI

Installation

npm install --save-dev umbra-reporter
# or
yarn add --dev umbra-reporter

Configuration

In playwright.config.ts:

import { defineConfig } from '@playwright/test'

export default defineConfig({
  reporter: [
    ['umbra-reporter']
  ],
  use: {
    trace: 'on-first-retry', // collect traces when a test retries after failure
  },
})

Reporter options

['umbra-reporter', {
  outputFile: 'playwright-report/index.html', // default
}]

Usage

npx playwright test
npx umbra-serve playwright-report/

Or add scripts to package.json:

{
  "scripts": {
    "test":  "playwright test",
    "serve": "umbra-serve playwright-report/"
  }
}

npm test && npm run serve
# or
yarn test && yarn serve

Port

Default is 3000. Override with PORT:

PORT=4000 npx umbra-serve playwright-report/

Trace viewer

umbra-serve uses the Playwright trace viewer bundled in playwright-core (already installed with @playwright/test). Clicking Open trace opens the viewer directly in the browser.

Without umbra-serve the report still works — a Copy button is shown instead (npx playwright show-trace <path>).

Trace collection modes

| Mode | When traces are saved | |---|---| | 'on-first-retry' | Only when a test fails and retries (default) | | 'on' | Always | | 'retain-on-failure' | Only for failed tests |

Requirements

• Node.js 18+
• @playwright/test ≥ 1.40