Reporter for the e2e Framework by TesterArmy

@testdino/e2e reports each test run from the e2e framework by TesterArmy ↗ to TestDino when the run finishes. The test run appears on the dashboard with its test cases, retries, steps, errors, console output, screenshots, videos, and traces. For Playwright, use the Node.js CLI instead.

Prerequisites

Node.js >= 22.12.0
e2e >= 0.16.0 and < 1
TestDino API key (generate one)
Git initialized repository (for commit and branch metadata)
@types/node, if you type-check your project with tsc

Installation

npm install @testdino/e2e

View @testdino/e2e on npm ↗.

Set up

Add testdino() to the reporters array in your e2e config. Other reporters, such as list, are optional and yours to keep.

e2e.config.ts

import type { E2EConfig } from 'e2e';
import { testdino } from '@testdino/e2e';

export default {
  targets: [/* your targets */],
  reporters: ['list', testdino()],
} satisfies E2EConfig;

Set your API key and run your tests:

export TESTDINO_TOKEN="your-api-key"
npx e2e run

When the run finishes, the TestDino line of the e2e output shows a link to the test run, or the number of test cases it uploaded.

Reporter options

Pass options to testdino(). An option set in the config takes precedence over its environment variable.

Option	Environment variable	Description
`token`	`TESTDINO_TOKEN`	Project API key. Without it, the reporter uploads nothing.
`ciRunId`	`TESTDINO_CI_RUN_ID`	Groups the shards of one run into a single test run.
`split`	`TESTDINO_SPLIT`	Split position, for example `2/3`. Needs `splitId`.
`splitId`	`TESTDINO_SPLIT_ID`	ID shared by every job of one split run.
`tags`	None	Run-level tags, for example `['nightly']`.
`artifacts`	None	Set `false` to keep screenshots, videos, and traces local.

e2e.config.ts

reporters: ['list', testdino({ tags: ['nightly'], artifacts: false })],

Sharded runs

Set the same TESTDINO_CI_RUN_ID on every shard. TestDino merges the shards into 1 test run.

TESTDINO_CI_RUN_ID="$CI_RUN_ID" npx e2e run --shard 1/2
TESTDINO_CI_RUN_ID="$CI_RUN_ID" npx e2e run --shard 2/2

On GitHub Actions, use ${{ github.run_id }}-${{ github.run_attempt }} as the ID. A shard started without TESTDINO_CI_RUN_ID uploads as its own test run.

Split mode

When your jobs run different files, use split mode instead of sharding. Give each job its position and the same split ID. TestDino merges the jobs into 1 test run.

TESTDINO_SPLIT=1/2 TESTDINO_SPLIT_ID="$SPLIT_ID" npx e2e run tests/checkout.e2e.ts
TESTDINO_SPLIT=2/2 TESTDINO_SPLIT_ID="$SPLIT_ID" npx e2e run tests/login.e2e.ts

Set both variables. Learn how to read the Splits panel in Split mode.

Differences from Playwright test runs

Area	e2e test runs
When results appear	After the test run finishes. There is no real-time streaming.
Targets	Each e2e target is shown as a project. The Configuration tab lists them under Targets.
Artifacts	PNG, JPEG, WebM, ZIP, JSON, TXT, and Markdown files up to 50 MB each. MP4 videos, such as device recordings, are not uploaded. Artifacts still uploading 40 seconds after the run finishes are not uploaded.
Visual comparison	Not available: e2e produces no expected, actual, or diff screenshots.
Test Controls	Not applied to the build result: a failing quarantined test case still fails the build.
Re-run commands and CI suggestions	Written for Playwright. They do not apply to e2e test runs.

Troubleshooting

skipped (TESTDINO_TOKEN is not set)

The reporter found no API key. Set TESTDINO_TOKEN in the environment that runs npx e2e run, or pass token to testdino(). Generate a new key from API Keys if needed.

not recorded (the project is over its execution limit)

Your organization used its executions for this billing cycle. Tests still run, but the test run is not saved. To resume recording, upgrade your plan, or on Pro and Team plans an Owner or Admin can add executions for this cycle.

not uploaded (no event channel the server offered could be reached)

The machine running the tests could not reach TestDino. Check that it allows outbound connections to TestDino, then run the tests again.

shards uploaded as separate runs: set TESTDINO_CI_RUN_ID to merge them

A shard ran without TESTDINO_CI_RUN_ID. Set the same value on every shard, as in Sharded runs.

split ignored: a split position and TESTDINO_SPLIT_ID are needed together

Only 1 of TESTDINO_SPLIT and TESTDINO_SPLIT_ID was set. Set both on every job, as in Split mode.

Configuration

Review the commit, CI, and targets of a test run

Generate API Keys

Create and manage keys for the reporter and CI

Getting Started

Connect Your Pipeline

Test Intelligence

Guides

AI-Native Testing

Organization & Access

Integrations

Test Management

Data Security & Privacy

Resources

Reporter for the e2e Framework by TesterArmy

Prerequisites

Installation

Set up

Reporter options

Sharded runs

Split mode

Differences from Playwright test runs

Troubleshooting

Configuration

Generate API Keys

​Prerequisites

​Installation

​Set up

​Reporter options

​Sharded runs

​Split mode

​Differences from Playwright test runs

​Troubleshooting

​Related

Configuration

Generate API Keys

Prerequisites

Installation

Set up

Reporter options

Sharded runs

Split mode

Differences from Playwright test runs

Troubleshooting

Related