Node.js CLI for Playwright

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

@testdino/playwright streams Playwright test results to TestDino as a run executes. Results appear on the dashboard live, with no separate upload step.

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

Prerequisites

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

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 live streaming works and when to use it

Generate API Keys

Create and manage tokens for the CLI and CI

Getting Started

Installation & Setup

AI & Automation

Debug & Analyze

Optimize CI

Test Management

Integrations

Administration

Quick Reference

Prerequisites

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

​Quick Reference

​Prerequisites

​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

Quick Reference

Prerequisites

Installation

Set up

CLI flags

Sharded runs

Code coverage

Environment variables

What gets collected

Use in CI/CD

Troubleshooting

Related