Node.js CLI for Playwright

@testdino/playwright streams Playwright test results to TestDino as a run executes. Results appear on the dashboard during the run, with no separate upload step. Paste the AI prompt below, or follow Installation and Set up.

Prerequisites

Node.js >= 18.0.0
@playwright/test >= 1.52.0
TestDino API token (generate one)
Git initialized repository (for commit and branch metadata)

Set up with an AI agent

Use this pre-built prompt to integrate @testdino/playwright into your project.

Open in Cursor

Quick Reference

Topic	Link	Best for
Install the package	Installation	First-time setup
Add TestDino to your config	Set up	Streaming results
CLI flags	CLI flags	Passing options
Group sharded runs	Sharded runs	CI with shards
Code coverage	Code coverage	Istanbul coverage

Installation

npm install @testdino/playwright

View the package on npm: @testdino/playwright ↗.

Set up

Add TestDino to the reporter array in your Playwright config. This is the only entry TestDino needs. Other reporters (html, list) are optional and yours to keep.

playwright.config.ts

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

export default defineConfig({
  reporter: [
    ['@testdino/playwright', {
      token: process.env.TESTDINO_TOKEN,
      serverUrl: "https://reporter.testdino.com",
    }],
  ],
});

Set your token and run tests the way you already do. Results stream to TestDino as the run executes.

export TESTDINO_TOKEN="$TESTDINO_TOKEN"
npx playwright test

Prefer not to edit your config?

Run tdpw test instead of npx playwright test. Same result, no config change.

npx tdpw test -t "$TESTDINO_TOKEN" --server-url https://reporter.testdino.com

It wraps npx playwright test, so any Playwright flag passes through, for example npx tdpw test --project=chromium --shard=1/3.

CLI flags

Set the token with -t or the TESTDINO_TOKEN environment variable. All other flags are optional.

npx tdpw test -t "$TESTDINO_TOKEN" --server-url https://reporter.testdino.com --tags "regression,smoke"

Flag	Environment variable	Description
`-t, --token <token>`	`TESTDINO_TOKEN`	API token. Required.
`--server-url <url>`	`TESTDINO_SERVER_URL`	Streaming endpoint. Use `https://reporter.testdino.com`.
`--ci-run-id <id>`	-	Group sharded runs into a single run
`--tags <csv>`	`TESTDINO_TAGS`	Run labels, comma-separated
`--coverage`	-	Collect Istanbul code coverage
`--no-artifacts`	-	Skip screenshot, video, and trace uploads
`--debug`	`TESTDINO_DEBUG`	Print debug logs

Sharded runs

Pass the same --ci-run-id to every shard. TestDino groups them into a single logical run on the dashboard.

npx tdpw test --ci-run-id "$CI_RUN_ID" -- --shard=1/4

In the config path, set the ciRunId option and pass --shard to npx playwright test as usual.

Code coverage

Instrument your app with Istanbul so it exposes window.__coverage__, import the TestDino fixture in your tests, then enable coverage:

npx tdpw test --coverage

Coverage merges across shards automatically. Learn more in Code Coverage.

Environment variables

Variable	Description
`TESTDINO_TOKEN`	Authentication token
`TESTDINO_SERVER_URL`	Streaming endpoint (`https://reporter.testdino.com`)
`TESTDINO_TAGS`	Default comma-separated run tags
`TESTDINO_DEBUG`	Enable debug logging

What gets collected

Category	Data
Git	Branch, commit hash, author, message, repository URL
CI	Provider, build ID, PR details
System	OS, CPU, memory, Node.js version
Playwright	Version, workers, projects, shard info
Artifacts	Screenshots, videos, traces (unless `--no-artifacts`)
Annotations	`testdino:` annotations from test metadata (guide)

Use in CI/CD

Set TESTDINO_TOKEN as a CI secret, keep TestDino in your playwright.config, and run npx playwright test. Each guide below has a full pipeline config with sharding and troubleshooting.

GitHub Actions

GitLab

TeamCity

Azure DevOps

CircleCI

AWS CodeBuild

Jenkins

Troubleshooting

Token is required but not provided

Set the token via --token, the TESTDINO_TOKEN environment variable, or the reporter option in playwright.config. Confirm it is set:

echo $TESTDINO_TOKEN

Generate a new token from API Keys if the issue persists.

Execution limit reached

Your account reached its monthly quota. Tests continue to run normally. Only streaming to TestDino pauses until the quota resets.Upgrade your plan or wait for the monthly reset.

Stream dropped, switched to HTTP fallback

Expected behavior. If the streaming connection drops, events fall back to HTTP delivery automatically. Your tests are never affected.

Enable debug logging

npx tdpw test --debug

Real-Time Test Streaming

How real-time streaming works and when to use it

Generate API Keys

Create and manage tokens for the CLI and CI

Getting Started

Installation & Setup

AI & MCP

Guides

Project

Test Management

Organization

Integrations

Data Privacy

Resources

Prerequisites

Set up with an AI agent

Quick Reference

Installation

Set up

CLI flags

Sharded runs

Code coverage

Environment variables

What gets collected

Use in CI/CD

GitHub Actions

GitLab

TeamCity

Azure DevOps

CircleCI

AWS CodeBuild

Jenkins

Troubleshooting

Real-Time Test Streaming

Generate API Keys

​Prerequisites

​Set up with an AI agent

​Quick Reference

​Installation

​Set up

​CLI flags

​Sharded runs

​Code coverage

​Environment variables

​What gets collected

​Use in CI/CD

GitHub Actions

GitLab

TeamCity

Azure DevOps

CircleCI

AWS CodeBuild

Jenkins

​Troubleshooting

​Related

Real-Time Test Streaming

Generate API Keys

Prerequisites

Set up with an AI agent

Quick Reference

Installation

Set up

CLI flags

Sharded runs

Code coverage

Environment variables

What gets collected

Use in CI/CD

Troubleshooting

Related