Skip to content

使用 Playwright Codegen 自动生成测试与定位器。

Playwright 可以自动生成测试,为快速开始测试提供了一种便捷方式。Codegen 会打开一个浏览器窗口供你交互,并打开 Playwright Inspector 以便记录、复制和管理生成的测试。

你将学会

  • 如何录制一个测试
  • 如何生成定位器

使用 codegen 命令运行测试生成器,后面跟上你想为其生成测试的网站 URL。URL 是可选的;如果省略,也可以直接在浏览器窗口中输入。

Terminal window
npx playwright codegen demo.playwright.dev/todomvc

运行 codegen,然后在浏览器中执行操作。Playwright 会自动为你的交互生成代码。Codegen 会分析渲染后的页面,并推荐最佳定位器,优先使用角色、文本和 test id 定位器。当多个元素匹配同一个定位器时,生成器会进一步优化它,以便唯一标识目标元素,从而减少测试失败和不稳定问题。

使用测试生成器,你可以录制:

  • 通过与页面交互来记录操作,例如点击或填写。
  • 通过点击工具栏图标,然后点击页面元素来记录断言。你可以选择:
    • 'assert visibility':断言某个元素可见。
    • 'assert text':断言某个元素包含特定文本。
    • 'assert value':断言某个元素具有特定值。

(图略)

当你完成页面交互后,按下 'record' 按钮停止录制,并使用 'copy' 按钮将生成的代码复制到你的编辑器中。

使用 'clear' 按钮可以清空代码并重新开始录制。完成后,关闭 Playwright Inspector 窗口,或者停止终端中的命令。

要进一步了解如何生成测试,请查看更详细的 Codegen 指南。

你可以使用测试生成器来生成 定位器

  • 按下 'Record' 按钮停止录制,此时会出现 'Pick Locator' 按钮。
  • 点击 'Pick Locator' 按钮,然后在浏览器窗口中悬停到元素上,即可看到该元素下方高亮显示的定位器。
  • 点击你想要定位的元素,该定位器对应的代码会显示在 'Pick Locator' 按钮旁边的定位器游乐场中。
  • 在定位器游乐场中编辑该定位器,以进行微调,并在浏览器窗口中查看高亮显示的匹配元素。
  • 使用复制按钮复制定位器,并将其粘贴到你的代码中。

你可以使用模拟功能,为特定的视口、设备、配色方案、地理位置、语言或时区生成测试。测试生成器还可以保留已认证状态。更多内容请参阅 Test Generator 指南。

  • 查看测试的追踪信息
-
0:000:00