Skip to main content

Reference

Deep-dive documentation for everything beyond the cookbooks. Each reference is self-contained with its own table of contents — load only what you need.

The content here is synced from .github/skills/playwright-test/references/ at build time — the same files Claude Code uses as its skill knowledge base. Edits there flow into this site on the next deploy.

Index

TopicWhen to read
Writing TestsLocators, assertions, structure, anti-patterns
Advanced ConfigEvery playwright.config.ts option that matters
CLI ReferenceAll useful CLI flags and recipes
FixturesCustom fixtures, scopes, composition — full API
NetworkRoute mocking, HAR recording, request inspection
AuthenticationAll four auth strategies in depth
DebuggingTrace viewer, UI mode, Inspector, flake hunting
CI / CDGitHub Actions, GitLab, sharding, Docker
ReportersHTML, JUnit, JSON, custom reporters
MCP IntegrationPlaywright MCP + Chrome DevTools MCP

How to use these docs as a reference, not a tutorial

The cookbooks teach. The references answer. If you're stuck:

  1. Find the topic above
  2. Use the page's table of contents to jump to the section
  3. Copy the example, adapt to your case

Each reference ends with a "common mistakes" or "anti-patterns" table — worth skimming when you're hunting a subtle bug.