Quick Reference
| Topic | Link |
|---|---|
| Enable streaming | Toggle on the Test Runs page |
| Setup | Install reporter and stream tests |
| WebSocket status | Connection indicator and states |
| Multi-tab support | BroadcastChannel coordination |
| Limitations | Beta caveats |
| FAQ | Common questions |
Enable Real-Time Streaming
A toggle switch on the Test Runs page header controls the streaming mode. Flip it to enable live updates.| Setting | Detail |
|---|---|
| Default state | OFF |
| Persistence | Saved to localStorage, persists across sessions |
| Beta badge | Displays next to the toggle when enabled |
- The Active Test Runs section renders at the top of the Test Runs page, showing runs currently executing.
- A WebSocket status badge indicates connection state.
- The onboarding setup guide switches to the Real-time tab.
Setup
Install the@testdino/playwright reporter and run tests with streaming enabled.
Run tests with streaming
tdpw test command wraps npx playwright test, opens a WebSocket connection, and streams each result to TestDino. All Playwright CLI options pass through.Monitor on the dashboard
Open the Test Runs page. Active runs appear at the top with a live progress bar, pass/fail/skip counts, and per-worker detail.
WebSocket Status
When real-time streaming is enabled, a status badge appears on the Test Runs page indicating the connection state.| Status | Meaning |
|---|---|
| Connecting | Establishing WebSocket connection to TestDino |
| Online | Connected and receiving live updates |
| Offline | Connection lost; updates are paused |
| Disconnected | WebSocket closed; toggle streaming off and on to reconnect |
Active Test Runs
With streaming enabled, the Test Runs page displays a collapsible Active Test Runs section. Each active run shows a progress bar, live result counts, commit, branch, and CI source.
For sharded runs, the run is labeled SHARDED with tabs for each shard. Select a tab to view its workers and currently executing tests.
Multi-Tab Support
Only one browser tab opens a WebSocket connection to TestDino. This tab acts as the primary tab. Additional tabs receive updates through the browser’s BroadcastChannel API.- If you close the primary tab, another open tab promotes itself and opens a new WebSocket.
- All tabs display the same live data regardless of which tab holds the connection.
Known Limitations
| Limitation | Detail |
|---|---|
| Beta status | Some edge cases in connection recovery are still being refined |
| Browser support | Requires a browser that supports WebSocket and BroadcastChannel (all modern browsers) |
| Single project | Each WebSocket connection is scoped to one project at a time |
| LocalStorage | Streaming preference is per-browser, not synced across devices |
FAQ
Will my test data be lost if I toggle streaming off?
Will my test data be lost if I toggle streaming off?
No. Toggling streaming off does not affect historical data. All previously recorded runs, test cases, and analytics remain intact. The toggle only changes how new results are delivered to the dashboard.
What happens if the WebSocket disconnects mid-run?
What happens if the WebSocket disconnects mid-run?
The reporter continues sending results. When the dashboard reconnects, it catches up to the current state. No test data is lost on the server side.