Node.js CLI for Playwright

Install @testdino/playwright and stream Playwright test results to TestDino live, with config setup, CLI flags, and CI usage.

@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.

CopiedCopy promptOpen 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

Related

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