用途:该技能通过 Playwright CLI 与 MCP 工具执行无头浏览器自动化,覆盖端到端测试、UI 验证、截图、网页抓取、表单提交测试、视觉回归、多页面流程校验以及基于浏览器的性能审计。单元测试、纯 API 测试、静态代码分析及个人浏览器会话不适用。
主要能力:MCP 提供 browser_navigate、browser_click、browser_fill_form、browser_take_screenshot、browser_snapshot、browser_evaluate、browser_press_key、browser_type、browser_select_option、browser_wait_for、browser_network_requests、browser_console_messages、browser_hover、browser_drag、browser_handle_dialog、browser_file_upload、browser_tabs、browser_navigate_back、browser_resize、browser_close、browser_install、browser_run_code 等工具。
使用方式:先加载工具,再导航、交互、逐步截图、用可访问性树或页面脚本断言,最后关闭浏览器。CLI 常用命令包括 npx playwright install chromium、npx playwright test、npx playwright test tests/e2e/login.spec.ts、npx playwright test --headed、npx playwright codegen http://localhost:3000、npx playwright show-report、npx playwright test --project=chromium。截图按 {step-number}-{description}.png 命名,存放于 ai-review/screenshots/、test-results/、playwright-report/。可通过 storageState 保存与复用登录态,支持并行执行(--workers=4)。
限制与注意:默认无头运行,仅在调试时使用 --headed;避免硬编码选择器,优先 data-testid 或可访问角色;显式设置超时;避免 page.waitForTimeout(),改用 page.waitForSelector() 或 browser_wait_for;CI 中不得使用有头浏览器;需检查网络请求与控制台错误,并管理好认证状态以防凭据泄露。具体配置与脚本细节以项目文件为准。