跳至主要内容

安装

简介​

Playwright Test 是专门为满足端到端测试的需求而创建的。Playwright 支持所有现代渲染引擎，包括 Chromium、WebKit 和 Firefox。在 Windows、Linux 和 macOS 上进行测试，无论是在本地还是在 CI 上，无论是否使用无头或有头模式，以及原生移动模拟 Google Chrome for Android 和 Mobile Safari。

您将学习

安装 Playwright​

使用 npm、yarn 或 pnpm 安装 Playwright 入门。或者，您也可以使用 VS Code 扩展 入门并运行测试。

npm init playwright@latest

运行安装命令并选择以下内容以开始使用

  • 在 TypeScript 或 JavaScript 之间选择（默认为 TypeScript）
  • 测试文件夹的名称（如果您的项目中已存在 tests 文件夹，则默认为 tests 或 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 个浏览器（chromium、firefox 和 webkit）上使用 3 个工作进程运行。这可以在 playwright.config 文件 中配置。测试在无头模式下运行，这意味着运行测试时不会打开任何浏览器。测试结果和测试日志将显示在终端中。

npx playwright test

命令行中运行的测试 请参阅我们关于 运行测试 的文档，以了解有关在有头模式下运行测试、运行多个测试、运行特定测试等的更多信息。

HTML 测试报告​

测试完成后，将生成一个 HTML 报告器，其中显示了测试的完整报告，允许您按浏览器、通过的测试、失败的测试、跳过的测试和不稳定的测试筛选报告。您可以点击每个测试并浏览测试的错误以及测试的每个步骤。默认情况下，如果某些测试失败，则会自动打开 HTML 报告。

npx playwright show-report

HTML Report

在 UI 模式下运行示例测试​

使用 UI 模式 运行测试，以获得更好的开发体验，包括时光倒流调试、观察模式等。

npx playwright test --ui

UI Mode

查看我们关于 UI 模式的详细指南，以了解有关其功能的更多信息。

更新 Playwright​

要将 Playwright 更新到最新版本，请运行以下命令

npm install -D @playwright/test@latest
# Also download new browser binaries and their dependencies:
npx playwright install --with-deps

您始终可以通过运行以下命令来检查 Playwright 的版本

npx playwright --version

系统要求​

  • Node.js 18+
  • Windows 10+、Windows Server 2016+ 或 Windows 子系统 Linux (WSL)。
  • macOS 13 Ventura 或 macOS 14 Sonoma。
  • Debian 11、Debian 12、Ubuntu 20.04 或 Ubuntu 22.04、Ubuntu 24.04，在 x86-64 和 arm64 架构上。

后续步骤​