将 Cypress 迁移至 Playwright,无需全部重写。
Nexus StudioQA 中的 Test Adapter 可按规则将 Cypress 和 WebdriverIO 测试转换为 Playwright,目前处于测试版阶段。您可以查看差异,所有断言均予保留,每项转换后的测试都会在正式生效前进行试运行。规则无法转换的内容会明确列出,不会隐藏。
作者:Verdict System LLC 的 Nexus StudioQA 团队。
最后更新: .
转换如何进行
无需手动重写,所有转换过程都清晰可见。
规则优先,AI 仅处理剩余部分
转换依靠一组固定规则,而非提示词。可选的 AI 仅处理规则未覆盖的部分,其代码与所有 AI 编写的测试一样,都须接受严格的 Vet 检查。如果您使用此功能,引擎会将对首次结果的评判反馈给编写方一次,且只有第二次结果不比首次差时,才会替换首次结果。
差异清晰可见
审核界面并排显示原始测试和转换后的测试,以及转换前后的断言数量。
保留所有断言
断言、条件、循环和等待均保持原样。如果转换后的测试会丢失断言,系统将阻止导入,除非您逐行确认接受。
每项测试正式生效前均先试运行
转换后的测试先在沙箱中运行,不写入任何证据或历史记录。每项测试须在三次试运行中均无异常,且每次使用不同的浏览器,之后才能离开沙箱。因此,仅能在 Chromium 上通过的测试会在第二次试运行时失败。
无法转换的内容始终可见
项目专用命令、视觉测试插件和
cy.task会连同原始代码行一起列为待处理项,交由可选的 AI 或您本人处理。曾对两个公开的 Cypress 测试套件进行一次测量:其中一个约有一半文件可完全按规则转换,无任何遗留项;另一个则没有文件能做到,因为其测试依赖项目代码。对于大型项目,预计部分文件需要完成这最后一步。
从源测试到当前处理方式
| 来源 | 当前处理方式 | 备注 |
|---|---|---|
| Cypress | 转换为 Playwright (测试版) | 展示差异, 保留断言, 并试运行每项测试. cy.task 和可视化测试插件会保留为未转换项. |
| WebdriverIO | 转换为 Playwright (测试版) | 采用相同的检查流程: 差异, 断言数量, 试运行. |
| 使用 JavaScript, TypeScript 或 Python 编写的 Selenium 测试 | 适配并导入 | 按规则改写到 Studio 的测试夹具中. 测试仍然是 Selenium 测试. |
Selenium IDE (.side) | 读取并编写为 JavaScript 或 Python 的 Playwright 测试 | 参见Selenium 和 Selenium IDE. |
| Playwright | 适配并导入 | 浏览器启动和设置移入 Studio 的测试夹具中; 断言保持不变. |
| Robot Framework | 实验性 | 不包含在测试版中. |
| Java 和 C# | 目前不支持转换 | 路线图中的下一步计划: 不仅能读取, 还能转换. |
| Katalon, TestRail, Gherkin, Appium 和 Postman | 目前不可用 | 已列入路线图的后续计划. 暂无日期. |
Selenium 和 Selenium IDE
Selenium 测试会进行适配, Selenium IDE 项目会被读取. 两者都无需从头重写.
Selenium 代码
在 mocha, jest, pytest 或 unittest 下使用 JavaScript, TypeScript 或 Python 编写的 Selenium 测试会按规则进行适配. 它们仍然是 Selenium 测试, 您的团队可以继续将其作为标准文件阅读和编辑.
Selenium IDE 项目
.side文件是纯 JSON, 适配器会原样读取. 每个定位器都来自 IDE 为该步骤记录的目标; 不会凭空生成任何定位器. 控制流 (if,while,times,do,forEach) 以及没有对应规则的命令都不会写入文件, 而是作为未转换项保留, 并附上原始代码行.
尚未提供的功能
完整列表及各项状态见路线图.
迁移验证
在您停用原始测试之前, 通过报告确认转换后的测试与原始测试行为一致. 这是下一步计划; 目前请通过试运行来检查.
转换 Java 和 C# 测试, 支持更多来源
Java 和 C# 转换是下一步计划. Katalon, Gherkin, Appium, Postman 和 TestRail 已列入路线图的后续计划. 这只是方向, 并非承诺: 暂无日期, 任何项目也可能被取消.