用途：在编写或审查 Playwright 测试时提供可复用的实践模式，提升测试稳定性与可维护性。
主要能力：
- 定位器优先顺序：getByRole、getByLabel、getByPlaceholder、getByText、getByAltText、getByTitle、getByTestId，CSS/XPath 仅作最后手段；支持链式过滤、and/or 组合与严格模式处理。
- Web-first 断言：使用 await expect(locator).toBeVisible() 等自动等待重试断言，支持软断言 expect.soft。
- Page Object Model：在构造函数中以 readonly 属性定义定位器，封装安全点击/填充等操作。
- Fixtures：优先于 beforeEach/afterEach，支持 worker 作用域与自动 fixture。
- 认证复用：通过 setup 项目保存 storageState，或用 API 认证更快；测试隔离，每个测试自建数据。
- 网络模拟：page.route、routeFromHAR 在导航前设置。
- 配置与调试：playwright.config.ts 中设置 baseURL、trace、projects、webServer；调试命令包括 npx playwright test --debug、--trace on、--ui、codegen、show-report。
必要用法：在 CLI 代理或 CI 中运行测试时必须使用最小 reporter 防止上下文溢出：npx playwright test --reporter=line 或 npx playwright test --reporter=dot。配置中可在 CI 或 CLAUDE 环境变量下默认使用 line reporter。启用调试日志：DEBUG=test:* npx playwright test。
适用场景：Node/TypeScript 项目的端到端测试，需处理认证、网络模拟、多浏览器项目与测试隔离时。
限制：资料未提供具体版本要求、安装步骤、定价或平台兼容性信息；部分命令与配置需结合项目实际环境调整。