一键将Cypress或Selenium测试套件迁移到Play…

# Cypress → Playwright 迁移指南

一、迁移前准备

• 在项目中安装 Playwright：npm i -D @playwright/test，并运行 npx playwright init 生成配置（或手动创建 playwright.config.ts）。
• 盘点 tests/e2e 下 87 个用例中用到的自定义命令（cy.xxx()）、fixtures、拦截（cy.intercept），列出等价 Playwright API。

二、核心 API 映射

• Mocha 语法：两者都支持 describe/it/beforeEach，基本可保留；cy.wrap().then 链式改为 await。
• 定位器转换：
• cy.get('[data-cy=btn]') → 优先 page.getByRole('button', { name: '...' })
• cy.contains('text') → page.getByText('...')
• cy.get('input[name=x]') → page.getByLabel('...') 或 getByPlaceholder
• cy.get('.list > div') → page.locator(css)
• cy.visit(url) → page.goto(url)
• 断言：cy.get(x).should('be.visible') → await expect(locator).toBeVisible()；导入 @playwright/test 的 expect。
• 网络拦截：cy.intercept → page.route()；cy.clock/tick → Playwright 的 Clock API。

三、批量迁移策略

• 脚本辅助：写一个 codemod（正则或 babel 处理），自动替换常见模式（cy.get、should(...)、visit），建议按用例分批（如每批 15–20 个）人工校验。
• 优先级：先迁简单冒烟用例跑通框架，再迁含 intercept、iframe、多 tab 的复杂用例。
• 删除 cypress/support/commands.js 后，改用 Playwright 的 fixtures 扩展自定义操作。

四、清理 Cypress 依赖

• 从 package.json 的 devDependencies 移除 cypress 及相关插件（如 @cypress/...），执行 npm install 更新 lock 文件。
• 删除 cypress.config.{js,ts}、cypress/ 目录、CI 中 cypress 相关步骤。
• scripts 中删除 cypress open/run 命令，替换为 playwright test。

五、验证与收尾

• npx playwright test 全量跑 87 条用例，关注 flaky 用例，必要时加 test.retry。
• 建议开启 trace（--trace on）便于排查失败。
• 提交前确认 lock 文件中已无 cypress 相关包。