SuperAPI AI 工具集

mcp-playwright

测试与质量

查看项目

更新于 10-15 07:54

技能介绍

用途

mcp-playwright 是一个 MCP 技能,用于在调试与验证过程中通过浏览器自动化完成任务。它使用配置为 microsoft/playwright-mcp 的 MCP 服务器(@playwright/mcp),执行导航、截图、DOM 检查等浏览器驱动操作,帮助确认 UI 流程是否符合预期。

主要能力

  • 浏览器导航与页面访问
  • 截图捕获(包括整页截图)
  • DOM 检查与元素可见性断言
  • 浏览器控制台错误与警告收集
  • UI 流程验证
  • 回归证据采集(截图 + 控制台错误)
  • 无障碍抽查(如关键控件的键盘焦点顺序)

使用方式

前置条件:

  • 确保 .vscode/mcp.json 中包含 microsoft/playwright-mcp。
  • 若在本地测试,确保应用正在运行(通常为 pnpm run start)。

操作规则:

  • 优先使用稳健选择器:data-testid、ARIA 角色/标签。
  • 避免脆弱的 CSS 选择器和深层 DOM 耦合。
  • 为回归捕获证据:截图 + 控制台错误。

典型工作流:

  • 路由冒烟检查:导航到某个 URL,断言主标题/地标可见。
  • 回归捕获:针对单个界面变更拍摄前后截图。
  • 控制台卫生:收集某个页面的浏览器控制台错误/警告。
  • 无障碍抽查:验证关键控件的键盘焦点顺序。

提示模板示例:

  • “打开 <URL> 并验证 <元素>。收集控制台错误并拍摄整页截图。”
  • “运行快速流程:<步骤>。使用基于角色的选择器,出错时快速失败并截图。”

相关仓库指引:

  • 测试组织与选择器规则参见 .github/skills/e2e-playwright。

适用场景

  • 调试或验证 Web 应用的 UI 行为
  • 执行端到端流程的快速检查
  • 采集回归测试所需的视觉与控制台证据
  • 对关键交互进行无障碍焦点顺序抽查

限制

  • 需要预先配置 microsoft/playwright-mcp 于 .vscode/mcp.json。
  • 本地测试需应用处于运行状态。
  • 具体安装命令、收费与价格、支持平台等信息暂未提供。