跳到主要内容

测试生成器

简介

Playwright 具备在您执行浏览器操作时为您生成测试的能力,是快速开始测试的好方法。Playwright 将查看您的页面并找出最佳定位器,优先考虑角色、文本和测试 ID 定位器。如果生成器找到多个匹配定位器的元素,它将改进定位器,使其具有弹性,从而唯一地标识目标元素。

使用 Playwright Inspector 生成测试

运行 codegen 命令时会打开两个窗口,一个浏览器窗口供您与要测试的网站交互,另一个 Playwright Inspector 窗口供您录制测试并将其复制到编辑器中。

运行 Codegen

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

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="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 选项生成具有不同视口大小的测试。

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen --viewport-size='800,600' playwright.dev"
Codegen generating code for tests for playwright.dev website with a specific viewport java

模拟设备

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

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args='codegen --device="iPhone 13" playwright.dev'
Codegen generating code for tests for playwright.dev website emulated for iPhone 13 java

模拟配色方案

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

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen --color-scheme=dark playwright.dev"
Codegen generating code for tests for playwright.dev website in dark mode java

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

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

  1. 接受 cookies
  2. 在右上角,单击“定位我”按钮以查看地理位置功能。
mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args='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 java

保留身份验证状态

运行带 --save-storagecodegen,以在会话结束时保存 cookieslocalStorageIndexedDB 数据。这对于单独录制身份验证步骤并在后续录制更多测试时重用它非常有用。

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen github.com/microsoft/playwright  --save-storage=auth.json"
github page before logging in java

登录

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

login to GitHub screen

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

加载身份验证状态

运行带 --load-storage 的命令以使用之前从 auth.json 加载的存储状态。这样,所有 cookieslocalStorageIndexedDB 数据都将恢复,使大多数 Web 应用无需再次登录即可进入身份验证状态。这意味着您可以从已登录状态继续生成测试。

mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen --load-storage=auth.json github.com/microsoft/playwright"
github signed in showing use of load storage java

使用自定义设置录制

如果您想在某些非标准设置中使用 codegen(例如,使用 BrowserContext.route()),可以调用 Page.pause(),这将打开一个带有 codegen 控件的单独窗口。

import com.microsoft.playwright.*;

public class Example {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
BrowserType chromium = playwright.chromium();
// Make sure to run headed.
Browser browser = chromium.launch(new BrowserType.LaunchOptions().setHeadless(false));
// Setup context however you like.
BrowserContext context = browser.newContext(/* pass any options */);
context.route("**/*", route -> route.resume());
// Pause the page, and start recording manually.
Page page = context.newPage();
page.pause();
}
}
}