playwright-best-practices 是一份覆盖面很广的 Playwright 测试导航，适合写新测试、修复 flaky、处理认证、文件、移动端、API、视觉、可访问性和 CI 等问题。它不要求所有项目一次读完整本，而是按当前活动加载对应参考文件。
写 E2E 测试时先看 suite structure、locators 和 assertions/waiting；需要 Page Object、fixtures、mock、OAuth、WebSocket 或多用户时，进入相应分支。测试失败先看错误和 trace，再修 locator、等待条件或隔离问题，不要用任意 sleep 把竞态遮住。移动端还要测触控、方向和真实断点。
测试完成后用项目配置的 Playwright 命令运行，并用标签、项目依赖和报告机制控制规模。它既覆盖代码正确性，也提醒你为网络失败、权限、离线和错误状态建立测试。