介绍
Playwright Test 是专门为了满足端到端测试的需求而创建的。Playwright 支持所有现代渲染引擎,包括 Chromium、WebKit 和 Firefox。在 Windows、Linux 和 macOS 上进行本地或 CI 测试,无头测试或使用适用于 Android 和 Mobile Safari 的 Google Chrome 的原生移动模拟进行测试。
你将学习
如何安装 Playwright
安装了什么
如何运行示例测试
如何打开 HTML 测试报告
安装 Playwright
¥Installing Playwright
通过使用 npm、yarn 或 pnpm 安装 Playwright 开始。或者,你也可以使用 VS Code 扩展 开始并运行测试。
npm
yarn
pnpm
npm init playwright@latest
运行安装命令并选择以下内容以开始:
在 TypeScript 或 JavaScript 之间进行选择(默认为 TypeScript)
你的测试文件夹的名称(如果你的项目中已有测试文件夹,则默认为测试或 e2e)
添加 GitHub Actions 工作流程以轻松在 CI 上运行测试
安装 Playwright 浏览器(默认为 true)
安装了什么
Playwright 将下载所需的浏览器并创建以下文件。
playwright.config.ts
package.json
package-lock.json
tests/
example.spec.ts
tests-examples/
demo-todo-app.spec.ts
你可以在 playwright.config 中添加 Playwright 的配置,包括修改你想要运行 Playwright 的浏览器。如果你在现有项目中运行测试,那么依赖将直接添加到你的 package.json。
tests 文件夹包含一个基本示例测试,可帮助你开始测试。有关更详细的示例,请查看 tests-examples 文件夹,其中包含为测试待办事项应用而编写的测试。
运行示例测试
默认情况下,测试将使用 3 个工作线程在所有 3 个浏览器(chromium、firefox 和 webkit)上运行。这可以在 playwright.config 文件 中配置。测试在无头模式下运行,这意味着运行测试时不会打开浏览器。测试结果和测试日志将显示在终端中。
npm
yarn
pnpm
npx playwright test
tests running in command line
请参阅我们的 运行测试 文档,了解有关在 head 模式下运行测试、运行多个测试、运行特定测试等的更多信息。
HTML 测试报告
测试完成后,将生成 HTML 报告器,其中显示完整的测试报告,允许你按浏览器、通过的测试、失败的测试、跳过的测试和不稳定测试来过滤报告。你可以单击每个测试并探索测试的错误以及测试的每个步骤。默认情况下,如果某些测试失败,将自动打开 HTML 报告。
npm
yarn
pnpm
npx playwright show-report
HTML Report
在 UI 模式下运行示例测试
使用 用户界面模式 运行测试,以获得更好的开发者体验,包括时间旅行调试、监视模式等。
npm
yarn
pnpm
npx playwright test --ui
UI Mode
查看 或 UI 模式详细指南 以了解有关其功能的更多信息。
更新 Playwright
要将 Playwright 更新到最新版本,请运行以下命令:
npm
yarn
pnpm
npm install -D @playwright/test@latest
Also download new browser binaries and their dependencies:
npx playwright install --with-deps
你始终可以通过运行以下命令来检查你拥有的 Playwright 版本:
npm
yarn
pnpm
npx playwright --version