跳到主要内容

测试生成器

引言​

Playwright 具有根据您在浏览器中的操作生成测试的能力，是快速入门测试的绝佳途径。Playwright 会查看您的页面并找出最佳定位器，优先使用 role、text 和 test id 定位器。如果生成器找到多个匹配定位器的元素，它会改进定位器，使其更具弹性，从而唯一标识目标元素。

使用 Playwright Inspector 生成测试​

运行 codegen 命令时，会打开两个窗口：一个浏览器窗口用于与您要测试的网站进行交互，另一个是 Playwright Inspector 窗口，您可以在其中录制测试并将其复制到编辑器中。

运行 Codegen​

使用 codegen 命令运行测试生成器，后跟您要为其生成测试的网站 URL。URL 是可选的，您始终可以不带 URL 运行命令，然后直接在浏览器窗口中添加 URL。

pwsh bin/Debug/netX/playwright.ps1 codegen demo.playwright.dev/todomvc

录制测试​

运行 codegen 命令并在浏览器窗口中执行操作。Playwright 会为用户交互生成代码，您可以在 Playwright Inspector 窗口中看到这些代码。完成测试录制后，停止录制并按下复制按钮将生成的测试复制到编辑器中。

使用测试生成器，您可以录制

  • 通过与页面进行交互来录制点击或填充等操作
  • 通过单击工具栏中的一个图标，然后单击页面上的元素来进行断言。您可以选择
    • 'assert visibility' 断言元素可见
    • 'assert text' 断言元素包含特定文本
    • 'assert value' 断言元素具有特定值

recording a test

​

完成与页面的交互后，按下录制按钮停止录制，并使用复制按钮将生成的代码复制到编辑器中。

使用清除按钮清除代码，以便重新开始录制。完成后，关闭 Playwright inspector 窗口或停止终端命令。

生成定位器​

您可以使用测试生成器生成定位器。

  • 按下 'Record' (录制) 按钮停止录制，'Pick Locator' (选择定位器) 按钮将出现。
  • 单击 'Pick Locator' (选择定位器) 按钮，然后将鼠标悬停在浏览器窗口中的元素上，以查看每个元素下方突出显示的定位器。
  • 要选择定位器，单击要定位的元素，该定位器的代码将出现在 Pick Locator 按钮旁边的字段中。
  • 然后，您可以在此字段中编辑定位器以进行微调，或使用复制按钮将其复制并粘贴到您的代码中。
​

picking a locator

模拟​

您可以使用测试生成器进行模拟，以生成针对特定视口、设备、配色方案的测试，还可以模拟地理位置、语言或时区。测试生成器还可以在保留身份验证状态的同时生成测试。

模拟视口大小​

Playwright 打开的浏览器窗口的视口已设置为特定的宽度和高度，并且不是响应式的，因为测试需要在相同的条件下运行。使用 --viewport 选项生成具有不同视口大小的测试。

pwsh bin/Debug/netX/playwright.ps1 codegen --viewport-size="800,600" playwright.dev
​
Codegen generating code for tests for playwright.dev website with a specific viewport dotnet

模拟设备​

使用 --device 选项模拟移动设备来录制脚本和测试，该选项会设置视口大小和用户代理等。

pwsh bin/Debug/netX/playwright.ps1 codegen --device="iPhone 13" playwright.dev
​
Codegen generating code for tests for playwright.dev website emulated for iPhone 13 csharp

模拟配色方案​

使用 --color-scheme 选项模拟配色方案来录制脚本和测试。

pwsh bin/Debug/netX/playwright.ps1 codegen --color-scheme=dark playwright.dev
​
Codegen generating code for tests for playwright.dev website in dark mode csharp

模拟地理位置、语言和时区​

使用 --timezone、--geolocation 和 --lang 选项模拟时区、语言和位置来录制脚本和测试。页面打开后

  1. 接受 cookie
  2. 在右上角，点击定位我按钮以查看地理位置功能。
pwsh bin/Debug/netX/playwright.ps1 codegen --timezone="Europe/Rome" --geolocation="41.890221,12.492348" --lang="it-IT" bing.com/maps
​
Codegen generating code for tests for bing maps showing timezone, geolocation as Rome, Italy and in Italian language csharp

保留身份验证状态​

运行 codegen 并带上 --save-storage 选项，可在会话结束时保存 cookie、localStorage 和 IndexedDB 数据。这对于单独录制身份验证步骤并在稍后录制更多测试时重复使用非常有用。

pwsh bin/Debug/netX/playwright.ps1 codegen github.com/microsoft/playwright --save-storage=auth.json
​
github page before logging in csharp

登录​

执行身份验证并关闭浏览器后，auth.json 将包含存储状态，您可以在测试中重复使用该状态。

login to GitHub screen

请确保仅在本地使用 auth.json，因为它包含敏感信息。将其添加到您的 .gitignore 文件中，或在生成测试完成后将其删除。

加载身份验证状态​

使用 --load-storage 运行以使用之前从 auth.json 加载的存储状态。通过这种方式，所有 cookie、localStorage 和 IndexedDB 数据都将恢复，使大多数 Web 应用程序无需再次登录即可进入身份验证状态。这意味着您可以从已登录状态继续生成测试。

pwsh bin/Debug/netX/playwright.ps1 codegen --load-storage=auth.json github.com/microsoft/playwright
​
github signed in showing use of load storage scharp

使用自定义设置进行录制​

如果您想在某些非标准设置中使用 codegen（例如，使用 BrowserContext.RouteAsync()），可以调用 Page.PauseAsync()，它将打开一个带有 codegen 控制的单独窗口。

using Microsoft.Playwright;

using var playwright = await Playwright.CreateAsync();
var chromium = playwright.Chromium;
// Make sure to run headed.
var browser = await chromium.LaunchAsync(new() { Headless = false });

// Setup context however you like.
var context = await browser.NewContextAsync(); // Pass any options
await context.RouteAsync("**/*", route => route.ContinueAsync());

// Pause the page, and start recording manually.
var page = await context.NewPageAsync();
await page.PauseAsync();