> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testdino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TestDino Glossary

> Definitions of TestDino and Playwright testing terms: flaky test, error grouping, trace viewer, failure classification, test execution, MCP, and more.

Definitions of the core terms used across TestDino and Playwright test reporting. Each entry gives a one-line definition, the key details, and a link to the feature that uses it.

## Quick Reference

| Term                                                | One-line definition                                            |
| :-------------------------------------------------- | :------------------------------------------------------------- |
| [Test run](#test-run)                               | One execution of a test suite that reports results to TestDino |
| [Test case](#test-case)                             | A single `test()` or `it()` block                              |
| [Test suite](#test-suite)                           | A set of test cases grouped in a spec file or project          |
| [Flaky test](#flaky-test)                           | A test that passes and fails without code changes              |
| [Failure classification](#failure-classification)   | The category assigned to a failure's root cause                |
| [Error grouping](#error-grouping)                   | Clustering failures by shared error message                    |
| [Trace viewer](#trace-viewer)                       | Step-by-step replay of a test execution                        |
| [Real-time streaming](#real-time-streaming)         | Live upload of results while tests run                         |
| [Test execution](#test-execution)                   | One billed unit: a single test case attempt                    |
| [Code coverage](#code-coverage)                     | Percentage of source code exercised by tests                   |
| [Stability score](#stability-score)                 | A test's pass rate across its run history                      |
| [MCP](#mcp-model-context-protocol)                  | Protocol that lets AI agents query TestDino                    |
| [Quality gate](#quality-gate)                       | Rules that pass or fail a CI check                             |
| [Environment mapping](#environment-mapping)         | Rules that tag runs by environment from the branch             |
| [Personal Access Token](#personal-access-token-pat) | A user-scoped credential for MCP and the API                   |

## Test run

**One execution of a Playwright test suite that reports its results to TestDino.**

* Carries metadata: branch, commit, CI provider, duration, pass/fail counts
* Links to the pull request that triggered it
* Tracked over time so you can compare runs across branches and pipelines

Explore the run view in [Test Runs](/platform/playwright-test-runs).

## Test case

**A single `test()` or `it()` block that runs and reports one result.**

* Result is one of: pass, fail, or flaky
* The smallest unit TestDino tracks
* The unit used to measure usage

See how cases are tracked in [Test Cases](/platform/playwright-test-cases).

## Test suite

**A set of test cases grouped together, usually by spec file or Playwright project.**

* Aggregates suite-level metrics: pass rate, duration, flakiness
* Helps locate the least stable areas of a codebase

Learn how suites fit together in [Key Concepts](/test-management/key-concepts).

## Flaky test

**A test that produces different results, passing in one run and failing in another, with no code change.**

How TestDino detects it:

| Scope               | Signal                          |
| :------------------ | :------------------------------ |
| Within a single run | Fails, then passes on retry     |
| Across runs         | Inconsistent outcomes over time |

Sub-categorized by root cause: Timing, Environment, Network, Assertion, or Other.

Read how detection works in [Flaky Test Detection](/guides/playwright-flaky-test-detection).

## Failure classification

**The category TestDino assigns to a failed test based on its likely root cause.**

The four categories:

| Category              | Meaning                                        |
| :-------------------- | :--------------------------------------------- |
| Actual Bug            | A real defect in the application               |
| UI Change             | An expected change that broke an assertion     |
| Unstable Test (Flaky) | Non-deterministic behavior, not a real failure |
| Miscellaneous         | Everything else (config, environment, infra)   |

Turns a wall of red into a triage queue, so teams fix real bugs first.

See how categories are assigned in [AI Failure Analysis](/platform/playwright-ai-failure-analysis).

## Error grouping

**Clustering of failed and flaky tests by their shared error message within a run.**

* Review 5 underlying errors instead of 40 individual failures
* Each group shows the affected test count
* Each group links to every test case it covers

Learn how grouping works in [Error Grouping](/guides/playwright-error-grouping).

## Trace viewer

**The step-by-step replay of a single test execution.**

Shows, in sequence:

* Each action and assertion
* Network calls and console logs
* DOM snapshots and screenshots

TestDino renders the standard Playwright trace in-platform, so you debug without downloading artifacts.

See it in action in the [Trace Viewer](/guides/playwright-trace-viewer) guide.

## Real-time streaming

**Upload of test results to TestDino while the run is still in progress.**

* Package: `@testdino/playwright`
* Command: `tdpw test`
* Status: experimental, may drop data

For reliable uploads, run tests normally and use `tdpw upload` after the run.

Set it up in [Real-Time Test Streaming](/guides/playwright-real-time-test-streaming).

## Test execution

**The billed unit of usage in TestDino: one attempt of one test case.**

| Counts as an execution                | Does not count                            |
| :------------------------------------ | :---------------------------------------- |
| Each test case attempt                | Skipped tests                             |
| Each retry (2 retries = 3 executions) | Attachments (screenshots, videos, traces) |

See how usage is metered in [Billing & Pricing](/pricing#how-usage-is-measured).

## Code coverage

**The percentage of application source code exercised by a test run, measured with Istanbul.**

* Ingested alongside test results
* Shows which code paths your Playwright suite reaches

Set it up in [Code Coverage](/guides/playwright-code-coverage).

## Stability score

**A test case's pass rate across its run history.**

* Formula: `(Passed / Total Runs) x 100`
* Quantifies how trustworthy a test is over time
* Scoped to the active branch

See per-test trends in [Test Case History](/platform/playwright-test-case-history).

## MCP (Model Context Protocol)

**The open protocol that lets AI agents read TestDino data in natural language.**

* Works with agents like Claude and Cursor
* An agent can query test runs, failures, and flaky tests, then reason about them in chat
* Optional: TestDino works fully through the dashboard, CLI, and integrations

Get started in the [MCP Overview](/mcp/overview).

## Quality gate

**Rules that determine whether a TestDino CI check passes or fails on a pull request.**

A gate can block a merge on:

* Failed tests
* Flaky tests
* A drop in pass rate

Configure gates in [GitHub Status Checks](/guides/github-status-checks).

## Environment mapping

**Rules that tag each test run with an environment based on its branch name.**

* Example: `main` maps to production, `staging` maps to staging
* Lets you filter analytics by environment
* Lets you compare stability across deployment targets

Set up rules in [Environment Mapping](/guides/environment-mapping).

## Personal Access Token (PAT)

**A user-scoped credential used to authenticate the MCP integration.**

| Token                 | Prefix | Scope   | Used by         |
| :-------------------- | :----- | :------ | :-------------- |
| Personal Access Token | `tpu_` | User    | MCP integration |
| Project Access Token  | `tdp_` | Project | Public API, CLI |

Create one in [Generate API Keys](/guides/generate-api-keys#token-prefixes).

## Related

<CardGroup cols={2}>
  <Card title="Key Concepts" icon="lightbulb" href="/test-management/key-concepts">
    How test cases, suites, and classification fields fit together
  </Card>

  <Card title="Getting Started" icon="rocket" href="/getting-started">
    Set up TestDino and upload your first run
  </Card>

  <Card title="Flaky Test Detection" icon="wave-pulse" href="/guides/playwright-flaky-test-detection">
    How TestDino finds and categorizes flaky tests
  </Card>

  <Card title="MCP Overview" icon="robot" href="/mcp/overview">
    Connect AI agents to your test data
  </Card>
</CardGroup>
