playwright

用途：在编写 Playwright 端到端（E2E）测试、实现 Page Object Model、使用 Playwright MCP 工具或制定测试策略时参考。

主要能力与模式：

1. MCP 工作流优先：写测试前先用 playwright_navigate 打开页面、playwright_snapshot 查看真实 DOM、playwright_click/playwright_fill 验证交互，再用已验证的选择器写测试。
2. 选择器优先级：getByRole > getByLabel > getByText > getByPlaceholder > getByTestId；避免 #id、CSS 类、nth-child 等脆弱选择器。
3. Page Object Model：以 BasePage 抽象类封装 navigate、waitForLoad、getNotification 等通用方法，各页面继承并暴露定位器与操作方法。
4. 可复用 Fixtures：用 base.extend 定义 loginPage、authenticatedPage 等夹具。
5. 测试文档：每个测试用例以 Markdown 记录优先级、前置条件、步骤与断言。

常用命令：npx playwright test；npx playwright test --grep "login"；npx playwright test --ui；npx playwright test --debug；npx playwright test auth/login.spec.ts；npx playwright show-report；npx playwright codegen http://localhost:3000。

规则与限制：所有选择器必须使用无障碍属性或 data-testid，禁止 CSS 类选择器；每个测试必须隔离，用 beforeEach/afterEach 做设置与清理；超过 3 个页面的测试套件必须使用 Page Object Model；断言须用内置自动等待匹配器（toBeVisible、toHaveText），不接受手动 waitForTimeout；测试文件须与所测功能同目录或放入专用 e2e/ 目录，不得与单元测试混放。

适用场景：Web UI 登录、仪表盘等流程的 E2E 测试与测试策略制定。具体安装与配置方式资料未提供。