# microsoft/playwright architecture

> Architecture diagram of the GitHub repository microsoft/playwright, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/playwright
- Repository: https://github.com/microsoft/playwright

## Overview

Playwright is a cross-browser automation and testing framework, also used for scripts and AI-agent workflows. A user invokes its API or test runner; client commands are handled by the automation server and browser-specific implementations, which drive a browser and return results. The repository also contains agent tools, trace inspection, and reporting interfaces. The graph combines documented product capabilities with relationships visible in the supplied excerpts or source index; several major subsystems are represented at their documented boundary because their implementation was not sampled.

Main entry points: [`packages/playwright-core/src/client/page.ts`](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/client/page.ts) (Automation client API), [`packages/playwright/src/runner/tasks.ts`](https://github.com/microsoft/playwright/blob/main/packages/playwright/src/runner/tasks.ts) (Test runner), [`packages/playwright-core/src/server/chromium/crNetworkManager.ts`](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/chromium/crNetworkManager.ts) (Chromium networking), [`packages/playwright-core/src/tools/backend/tool.ts`](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/backend/tool.ts) (Browser agent tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["Playwright CLI<br/>[program.ts]"]
  node_api["Automation client API<br/>[page.ts]"]
end

subgraph group_automation["Automation runtime"]
  node_client_network["Client networking<br/>[network.ts]"]
  node_context["Browser contexts<br/>[browserContext.ts]"]
  node_frames["Frames and waits<br/>[frames.ts]"]
  node_server_page["Server pages<br/>[page.ts]"]
  node_selectors["Accessible selectors<br/>[roleUtils.ts]"]
  node_role_engine["Role selector engine"]
  node_locator_generation["Locator generation"]
end

subgraph group_browser["Browser integrations"]
  node_chromium_page["Chromium pages<br/>[crPage.ts]"]
  node_chromium_network["Chromium networking"]
  node_firefox["Firefox backend<br/>[firefox.ts]"]
  node_webkit["WebKit backend<br/>[webkit.ts]"]
end

subgraph group_test["Testing and results"]
  node_test_runner["Test runner<br/>[tasks.ts]"]
  node_reporter["HTML report<br/>[index.tsx]"]
end

subgraph group_inspection["Agent and trace tools"]
  node_trace["Trace model<br/>[trace.ts]"]
  node_snapshot_renderer["Snapshot renderer"]
  node_trace_viewer["Trace viewer loader<br/>[main.ts]"]
  node_agent_tools["Browser agent tools<br/>[tool.ts]"]
  node_storage_tools["Storage tools<br/>[webstorage.ts]"]
  node_dashboard["Session dashboard"]
end

node_user(("Developer or agent"))

node_user -->|"runs commands"| node_cli
node_user -->|"uses automation"| node_api
node_cli -->|"runs tests"| node_test_runner
node_api -->|"uses networking"| node_client_network
node_context -->|"configures requests"| node_chromium_network
node_chromium_network -->|"routes requests"| node_frames
node_chromium_network -->|"routes requests"| node_server_page
node_role_engine -->|"queries roles"| node_selectors
node_trace_viewer -->|"loads traces"| node_trace
node_snapshot_renderer -->|"reads entries"| node_trace
node_agent_tools -->|"registers tools"| node_storage_tools
node_user -->|"runs browser tests"| node_test_runner
node_test_runner -.->|"isolates tests"| node_context
node_test_runner -.->|"produces reports"| node_reporter
node_test_runner -.->|"captures traces"| node_trace
node_api -.->|"drives browser"| node_chromium_page
node_api -.->|"drives browser"| node_firefox
node_api -.->|"drives browser"| node_webkit
node_api -.->|"supports locators"| node_locator_generation
node_user -.->|"requests automation"| node_agent_tools
node_dashboard -.->|"monitors sessions"| node_agent_tools

click node_cli "https://github.com/microsoft/playwright/blob/main/packages/playwright/src/program.ts"
click node_api "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/client/page.ts"
click node_test_runner "https://github.com/microsoft/playwright/blob/main/packages/playwright/src/runner/tasks.ts"
click node_client_network "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/client/network.ts"
click node_context "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/browserContext.ts"
click node_frames "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/frames.ts"
click node_server_page "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/page.ts"
click node_chromium_page "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/chromium/crPage.ts"
click node_chromium_network "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/chromium/crNetworkManager.ts"
click node_firefox "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/firefox/firefox.ts"
click node_webkit "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/webkit/webkit.ts"
click node_selectors "https://github.com/microsoft/playwright/blob/main/packages/injected/src/roleUtils.ts"
click node_role_engine "https://github.com/microsoft/playwright/blob/main/packages/injected/src/roleSelectorEngine.ts"
click node_locator_generation "https://github.com/microsoft/playwright/blob/main/packages/isomorphic/locatorGenerators.ts"
click node_trace "https://github.com/microsoft/playwright/blob/main/packages/isomorphic/trace/trace.ts"
click node_snapshot_renderer "https://github.com/microsoft/playwright/blob/main/packages/isomorphic/trace/snapshotRenderer.ts"
click node_trace_viewer "https://github.com/microsoft/playwright/blob/main/packages/trace-viewer/src/sw/main.ts"
click node_reporter "https://github.com/microsoft/playwright/blob/main/packages/html-reporter/src/index.tsx"
click node_agent_tools "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/backend/tool.ts"
click node_storage_tools "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/backend/webstorage.ts"
click node_dashboard "https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/dashboard/dashboardController.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_api toneBlue
class node_client_network,node_context,node_frames,node_server_page,node_selectors,node_role_engine,node_locator_generation toneAmber
class node_chromium_page,node_chromium_network,node_firefox,node_webkit toneMint
class node_test_runner,node_reporter toneRose
class node_trace,node_snapshot_renderer,node_trace_viewer,node_agent_tools,node_storage_tools,node_dashboard,node_user toneIndigo
```

## Components

### User entry points

- [Playwright CLI](https://github.com/microsoft/playwright/blob/main/packages/playwright/src/program.ts): `packages/playwright/src/program.ts`
- [Automation client API](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/client/page.ts): `packages/playwright-core/src/client/page.ts`

### Automation runtime

- [Client networking](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/client/network.ts): `packages/playwright-core/src/client/network.ts`
- [Browser contexts](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/browserContext.ts): `packages/playwright-core/src/server/browserContext.ts`
- [Frames and waits](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/frames.ts): `packages/playwright-core/src/server/frames.ts`
- [Server pages](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/page.ts): `packages/playwright-core/src/server/page.ts`
- [Accessible selectors](https://github.com/microsoft/playwright/blob/main/packages/injected/src/roleUtils.ts): `packages/injected/src/roleUtils.ts`
- [Role selector engine](https://github.com/microsoft/playwright/blob/main/packages/injected/src/roleSelectorEngine.ts): `packages/injected/src/roleSelectorEngine.ts`
- [Locator generation](https://github.com/microsoft/playwright/blob/main/packages/isomorphic/locatorGenerators.ts): `packages/isomorphic/locatorGenerators.ts`

### Browser integrations

- [Chromium pages](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/chromium/crPage.ts): `packages/playwright-core/src/server/chromium/crPage.ts`
- [Chromium networking](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/chromium/crNetworkManager.ts): `packages/playwright-core/src/server/chromium/crNetworkManager.ts`
- [Firefox backend](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/firefox/firefox.ts): `packages/playwright-core/src/server/firefox/firefox.ts`
- [WebKit backend](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/webkit/webkit.ts): `packages/playwright-core/src/server/webkit/webkit.ts`

### Testing and results

- [Test runner](https://github.com/microsoft/playwright/blob/main/packages/playwright/src/runner/tasks.ts): `packages/playwright/src/runner/tasks.ts`
- [HTML report](https://github.com/microsoft/playwright/blob/main/packages/html-reporter/src/index.tsx): `packages/html-reporter/src/index.tsx`

### Agent and trace tools

- [Trace model](https://github.com/microsoft/playwright/blob/main/packages/isomorphic/trace/trace.ts): `packages/isomorphic/trace/trace.ts`
- [Snapshot renderer](https://github.com/microsoft/playwright/blob/main/packages/isomorphic/trace/snapshotRenderer.ts): `packages/isomorphic/trace/snapshotRenderer.ts`
- [Trace viewer loader](https://github.com/microsoft/playwright/blob/main/packages/trace-viewer/src/sw/main.ts): `packages/trace-viewer/src/sw/main.ts`
- [Browser agent tools](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/backend/tool.ts): `packages/playwright-core/src/tools/backend/tool.ts`
- [Storage tools](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/backend/webstorage.ts): `packages/playwright-core/src/tools/backend/webstorage.ts`
- [Session dashboard](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/tools/dashboard/dashboardController.ts): `packages/playwright-core/src/tools/dashboard/dashboardController.ts`

### Other components

- **Developer or agent**

## Connections

- Developer or agent → Playwright CLI: runs commands (evidence: `packages/playwright/src/program.ts`)
- Developer or agent → Automation client API: uses automation (evidence: `README.md`)
- Playwright CLI → Test runner: runs tests (evidence: `packages/playwright/src/program.ts`)
- Automation client API → Client networking: uses networking (evidence: `packages/playwright-core/src/client/page.ts`)
- Browser contexts → Chromium networking: configures requests (evidence: `packages/playwright-core/src/server/chromium/crNetworkManager.ts`)
- Chromium networking → Frames and waits: routes requests (evidence: `packages/playwright-core/src/server/chromium/crNetworkManager.ts`)
- Chromium networking → Server pages: routes requests (evidence: `packages/playwright-core/src/server/chromium/crNetworkManager.ts`)
- Role selector engine → Accessible selectors: queries roles (evidence: `packages/injected/src/roleSelectorEngine.ts`)
- Trace viewer loader → Trace model: loads traces (evidence: `packages/trace-viewer/src/sw/main.ts`)
- Snapshot renderer → Trace model: reads entries (evidence: `packages/isomorphic/trace/snapshotRenderer.ts`)
- Browser agent tools → Storage tools: registers tools (evidence: `packages/playwright-core/src/tools/backend/webstorage.ts`)
- Developer or agent → Test runner: runs browser tests (evidence: `README.md`)
- Test runner → Browser contexts: isolates tests (evidence: `README.md`)
- Test runner → HTML report: produces reports (evidence: `README.md`)
- Test runner → Trace model: captures traces (evidence: `README.md`)
- Automation client API → Chromium pages: drives browser (evidence: `README.md`)
- Automation client API → Firefox backend: drives browser (evidence: `README.md`)
- Automation client API → WebKit backend: drives browser (evidence: `README.md`)
- Automation client API → Locator generation: supports locators (evidence: `README.md`)
- Developer or agent → Browser agent tools: requests automation (evidence: `README.md`)
- Session dashboard → Browser agent tools: monitors sessions (evidence: `packages/playwright-core/src/tools/dashboard/dashboardController.ts`)
