How microsoft/playwright works
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: page.ts Automation client API · tasks.ts Test runner · crNetworkManager.ts Chromium networking · tool.ts Browser agent tools
Components 22
User entry points
- Playwright CLI
packages/playwright/src/program.ts - Automation client API
packages/playwright-core/src/client/page.ts
Automation runtime
- Client networking
packages/playwright-core/src/client/network.ts - Browser contexts
packages/playwright-core/src/server/browserContext.ts - Frames and waits
packages/playwright-core/src/server/frames.ts - Server pages
packages/playwright-core/src/server/page.ts - Accessible selectors
packages/injected/src/roleUtils.ts - Role selector engine
packages/injected/src/roleSelectorEngine.ts - Locator generation
packages/isomorphic/locatorGenerators.ts
Browser integrations
- Chromium pages
packages/playwright-core/src/server/chromium/crPage.ts - Chromium networking
packages/playwright-core/src/server/chromium/crNetworkManager.ts - Firefox backend
packages/playwright-core/src/server/firefox/firefox.ts - WebKit backend
packages/playwright-core/src/server/webkit/webkit.ts
Testing and results
- Test runner
packages/playwright/src/runner/tasks.ts - HTML report
packages/html-reporter/src/index.tsx
Agent and trace tools
- Trace model
packages/isomorphic/trace/trace.ts - Snapshot renderer
packages/isomorphic/trace/snapshotRenderer.ts - Trace viewer loader
packages/trace-viewer/src/sw/main.ts - Browser agent tools
packages/playwright-core/src/tools/backend/tool.ts - Storage tools
packages/playwright-core/src/tools/backend/webstorage.ts - Session dashboard
packages/playwright-core/src/tools/dashboard/dashboardController.ts
Other components
- Developer or agent
Connections 21
- Developer or agent → Playwright CLI: runs commands
packages/playwright/src/program.ts - Developer or agent → Automation client API: uses automation
README.md - Playwright CLI → Test runner: runs tests
packages/playwright/src/program.ts - Automation client API → Client networking: uses networking
packages/playwright-core/src/client/page.ts - Browser contexts → Chromium networking: configures requests
packages/playwright-core/src/server/chromium/crNetworkManager.ts - Chromium networking → Frames and waits: routes requests
packages/playwright-core/src/server/chromium/crNetworkManager.ts - Chromium networking → Server pages: routes requests
packages/playwright-core/src/server/chromium/crNetworkManager.ts - Role selector engine → Accessible selectors: queries roles
packages/injected/src/roleSelectorEngine.ts - Trace viewer loader → Trace model: loads traces
packages/trace-viewer/src/sw/main.ts - Snapshot renderer → Trace model: reads entries
packages/isomorphic/trace/snapshotRenderer.ts - Browser agent tools → Storage tools: registers tools
packages/playwright-core/src/tools/backend/webstorage.ts - Developer or agent → Test runner: runs browser tests
README.md - Test runner → Browser contexts: isolates tests
README.md - Test runner → HTML report: produces reports
README.md - Test runner → Trace model: captures traces
README.md - Automation client API → Chromium pages: drives browser
README.md - Automation client API → Firefox backend: drives browser
README.md - Automation client API → WebKit backend: drives browser
README.md - Automation client API → Locator generation: supports locators
README.md - Developer or agent → Browser agent tools: requests automation
README.md - Session dashboard → Browser agent tools: monitors sessions
packages/playwright-core/src/tools/dashboard/dashboardController.ts