@devant-q/playwright-reporter

Playwright reporter that streams test results, artifacts, and CI metadata to your Devant Q dashboard in real time.

Pre-release: Install with the @next tag until a stable release is published.

Installation

npm install -D @devant-q/playwright-reporter@next

Setup

Add the reporter to your playwright.config.ts:

import { defineConfig } from "@playwright/test";

export default defineConfig({
  reporter: [
    ["@devant-q/playwright-reporter", {
      apiUrl: "https://cloud.devant.net",
      apiToken: process.env.DEVANT_TOKEN,
    }],
  ],
});

To keep terminal output alongside dashboard reporting:

reporter: [
  ["@devant-q/playwright-reporter", { apiUrl: "...", apiToken: process.env.DEVANT_TOKEN }],
  ["list"],
],

Options

| Option | Type | Required | Default | Description | |--------|------|----------|---------|-------------| | apiUrl | string | Yes | — | Dashboard base URL | | apiToken | string | Yes | — | API bearer token | | projectName | string | No | Playwright project name | Override the project name sent to the dashboard | | uploadReport | boolean | No | false | Upload the Playwright HTML report after the run | | reportDir | string | No | playwright-report | HTML report output directory |

CI Integration

The reporter auto-detects your CI environment and attaches branch, commit, and pull request metadata to each run. Supported providers:

• GitHub Actions
• GitLab CI
• CircleCI
• Jenkins
• Azure DevOps

No configuration needed — detection is based on standard CI environment variables.

Artifact Upload

Screenshots, videos, and traces are uploaded automatically after each test. Files over 5 MB are uploaded directly to storage via presigned URLs; smaller files are proxied through the API.

HTML Report Upload

To upload the full Playwright HTML report and access it from your dashboard:

["@devant-q/playwright-reporter", {
  apiUrl: "...",
  apiToken: process.env.DEVANT_TOKEN,
  uploadReport: true,
  reportDir: "playwright-report", // optional, this is the default
}]

License

MIT