运行和调试测试
简介
使用 Playwright,您可以运行单个测试、一组测试或所有测试。可以使用 --project
标志在一个或多个浏览器上运行测试。测试默认并行运行,并以无头模式运行,这意味着在运行测试时不会打开浏览器窗口,结果会显示在终端中。您可以使用 --headed
CLI 参数以有头模式运行测试,或者使用 --ui
标志以UI 模式运行测试,以查看测试的完整跟踪。
您将学到
运行测试
命令行
您可以使用 playwright test
命令运行测试。这会在 playwright.config
文件中配置的所有浏览器上运行测试,结果会显示在终端中。测试默认以无头模式运行,这意味着在运行测试时不会打开浏览器窗口。
npx playwright test
在 UI 模式下运行测试
我们强烈建议您使用UI 模式运行测试,以获得更好的开发体验,您可以在其中轻松地逐步完成测试的每一步,并直观地看到每个步骤之前、期间和之后发生的情况。UI 模式还具有许多其他功能,例如定位器选择器、监视模式等。
npx playwright test --ui
请查看我们的UI 模式详细指南,了解其功能。
在有头模式下运行测试
要在有头模式下运行测试,请使用 --headed
标志。这使您能够直观地看到 Playwright 如何与网站交互。
npx playwright test --headed
在不同浏览器上运行测试
要指定要在哪个浏览器上运行测试,请使用 --project
标志,后跟浏览器名称。
npx playwright test --project webkit
要指定多个浏览器来运行测试,请多次使用 --project
标志,后跟每个浏览器名称。
npx playwright test --project webkit --project firefox
运行特定测试
要运行单个测试文件,请传入要运行的测试文件名。
npx playwright test landing-page.spec.ts
要运行来自不同目录的一组测试文件,请传入要运行测试的目录名称。
npx playwright test tests/todo-page/ tests/landing-page/
要运行文件名中包含 landing
或 login
的文件,只需将这些关键字传入 CLI 即可。
npx playwright test landing login
要运行具有特定标题的测试,请使用 -g
标志,后跟测试标题。
npx playwright test -g "add a todo item"
运行上次失败的测试
要仅运行上次测试运行中失败的测试,请先运行测试,然后再次使用 --last-failed
标志运行它们。
npx playwright test --last-failed
在 VS Code 中运行测试
可以使用 VS Code 扩展直接在 VS Code 中运行测试。安装后,您只需单击要运行的测试旁边的绿色三角形,或从测试侧边栏运行所有测试。有关更多详细信息,请查看我们的VS Code 入门指南。
调试测试
由于 Playwright 在 Node.js 中运行,因此您可以使用您选择的调试器(例如,在您的 IDE 中使用 console.log
,或直接在 VS Code 中使用VS Code 扩展)进行调试。Playwright 附带UI 模式,您可以在其中轻松地逐步完成测试的每一步,查看日志、错误、网络请求、检查 DOM 快照等等。您还可以使用Playwright Inspector,它允许您逐步执行 Playwright API 调用,查看其调试日志,并探索定位器。
在 UI 模式下调试测试
我们强烈建议您使用UI 模式调试测试,以获得更好的开发体验,您可以在其中轻松地逐步完成测试的每一步,并直观地看到每个步骤之前、期间和之后发生的情况。UI 模式还具有许多其他功能,例如定位器选择器、监视模式等。
npx playwright test --ui
在调试时,您可以使用“选取定位器”按钮选择页面上的元素,并查看 Playwright 将用于查找该元素的定位器。您还可以在定位器游乐场中编辑定位器,并实时查看它在浏览器窗口中高亮显示。使用“复制定位器”按钮将定位器复制到剪贴板,然后将其粘贴到您的测试中。
请查看我们的UI 模式详细指南,了解其功能。
使用 Playwright Inspector 调试测试
要调试所有测试,请运行 Playwright 测试命令,后跟 --debug
标志。
npx playwright test --debug
此命令会打开一个浏览器窗口以及 Playwright Inspector。您可以使用检查器顶部的“跳过”按钮逐步执行测试。或者,按播放按钮从头到尾运行测试。测试完成后,浏览器窗口会关闭。
要调试一个测试文件,请运行 Playwright 测试命令,后跟要调试的测试文件名,后跟 --debug
标志。
npx playwright test example.spec.ts --debug
要从定义 test(..
的行号开始调试特定测试,请在测试文件名末尾添加一个冒号,后跟行号,然后是 --debug
标志。
npx playwright test example.spec.ts:10 --debug
在调试时,您可以使用“选取定位器”按钮选择页面上的元素,并查看 Playwright 将用于查找该元素的定位器。您还可以编辑定位器,并实时查看它在浏览器窗口中高亮显示。使用“复制定位器”按钮将定位器复制到剪贴板,然后将其粘贴到您的测试中。
请查看我们的调试指南,了解如何使用VS Code 调试器、UI 模式和Playwright Inspector进行调试,以及使用浏览器开发者工具进行调试。
测试报告
HTML 报告器会显示您的测试的完整报告,允许您按浏览器、通过的测试、失败的测试、跳过的测试和不稳定的测试过滤报告。默认情况下,如果某些测试失败,HTML 报告会自动打开,否则您可以使用以下命令打开它。
npx playwright show-report
您可以筛选和搜索测试,并单击每个测试以查看测试错误并探索测试的每个步骤。