跳到主要内容

设置 CI

简介

Playwright 测试可以在任何 CI 提供商上运行。在本节中,我们将介绍如何使用 GitHub Actions 在 GitHub 上运行测试。如果你想了解如何配置其他 CI 提供商,请查阅我们关于持续集成的详细文档。

你将学到

设置 GitHub Actions

要添加一个 GitHub Actions 文件,首先创建一个 .github/workflows 文件夹,并在其中添加一个 playwright.yml 文件,其中包含下面的示例代码,以便您的测试将在 main/master 分支的每次 push 和 pull request 时运行。

.github/workflows/playwright.yml
name: Playwright Tests
on:
push:
branches: [ main, master ]
pull_request:
branches: [ main, master ]
jobs:
test:
timeout-minutes: 60
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup dotnet
uses: actions/setup-dotnet@v4
with:
dotnet-version: 8.0.x
- name: Build & Install
run: dotnet build
- name: Ensure browsers are installed
run: pwsh bin/Debug/net8.0/playwright.ps1 install --with-deps
- name: Run your tests
run: dotnet test

要了解更多信息,请参阅“理解 GitHub Actions”

查看 jobs.test.steps 中的步骤列表,您可以看到工作流程执行了以下步骤

  1. 克隆您的仓库
  2. 安装语言依赖项
  3. 安装项目依赖项并构建
  4. 安装 Playwright 浏览器
  5. 运行测试

创建仓库并推送到 GitHub

设置好您的 GitHub Actions 工作流程后,您只需在 GitHub 上创建一个仓库或将代码推送到现有仓库即可。遵循 GitHub 上的说明,不要忘记使用 git init 命令初始化一个 git 仓库,这样您就可以添加提交推送您的代码。

dotnet repo on github

打开工作流程

点击 Actions 标签页查看工作流程。在这里您将看到您的测试是通过还是失败。

opening the workflow

在 Pull Requests 中,您还可以点击PR 状态检查中的 Details 链接。

pr status checked

查看测试日志

点击工作流程运行将显示 GitHub 执行的所有操作,点击 Run Playwright tests 将显示错误消息、预期结果和实际结果以及调用日志。

viewing the test logs

查看跟踪

您可以上传在 CI(如 GitHub Actions)上作为 artifacts 创建的跟踪。这需要启动和停止跟踪。我们建议只为失败的测试记录跟踪。将跟踪上传到 CI 后,可以使用 trace.playwright.dev 下载并打开它们,trace.playwright.dev 是跟踪查看器的静态托管版本。您可以使用拖放方式上传跟踪文件。

playwright trace viewer

下一步