用途:把浏览器 MCP 当作录制器,在 Cursor 内置浏览器中逐步执行用户流程,记录每次导航、点击、填写和按键,再由智能体将轨迹翻译成仓库中的 Playwright 测试文件或可粘贴到现有 spec 的片段。
主要能力:结合 browser_snapshot(引用、角色、名称)与结构化动作,而非独立录制扩展。每步先取快照,再选择最小交互:browser_click(用快照 ref,非坐标)、browser_fill 或 browser_type、browser_select_option、browser_navigate。记录步骤号、动作动词、Playwright 定位策略(优先 getByRole、getByLabel、getByPlaceholder、getByTestId)、值或 URL,以及可选断言。DOM 变化或导航后重新快照;异步内容用 browser_wait_for 或短增量等待后再快照。最后补充 expect(page).toHaveURL 和至少一个可见结果断言,生成如 tests/recorded/<flow-name>.spec.ts 的测试文件,不含会话专属的原始快照 ref。
使用方式:先确保目标应用可访问(如开发服务器运行,可用 finding-dev-server-url),仓库已安装 @playwright/test(否则用 adding-e2e-tests 或项目标准方式添加)。用一句话定义流程范围,逐步录制并记录,生成测试后运行 npx playwright test tests/recorded/<flow-name>.spec.ts,再修复不稳定:点击前用 expect(locator).toBeVisible(),异步列表用 toPass() 重试,避免随意 waitForTimeout。
适用场景:需要把手工浏览器操作固化为可重放端到端测试的流程。
限制:需要手动 2FA、验证码或邮件链接的流程不适用,应停止并请用户提供测试绕过或 mock。登录流程用环境变量或 storageState,切勿提交密钥;并行运行时确保测试数据不冲突。