设置 CI
简介
Playwright 测试可以在任何 CI 提供商上运行。在本节中,我们将介绍如何使用 GitHub Actions 在 GitHub 上运行测试。如果你想了解如何配置其他 CI 提供商,请查阅我们关于持续集成的详细文档。
你将学到
设置 GitHub Actions
要添加一个 GitHub Actions 文件,首先创建一个 .github/workflows
文件夹,并在其中添加一个 playwright.yml
文件,其中包含下面的示例代码,以便您的测试将在 main/master 分支的每次 push 和 pull request 时运行。
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
中的步骤列表,您可以看到工作流程执行了以下步骤
- 克隆您的仓库
- 安装语言依赖项
- 安装项目依赖项并构建
- 安装 Playwright 浏览器
- 运行测试
创建仓库并推送到 GitHub
设置好您的 GitHub Actions 工作流程后,您只需在 GitHub 上创建一个仓库或将代码推送到现有仓库即可。遵循 GitHub 上的说明,不要忘记使用 git init
命令初始化一个 git 仓库,这样您就可以添加、提交和推送您的代码。
打开工作流程
点击 Actions 标签页查看工作流程。在这里您将看到您的测试是通过还是失败。
在 Pull Requests 中,您还可以点击PR 状态检查中的 Details 链接。

查看测试日志
点击工作流程运行将显示 GitHub 执行的所有操作,点击 Run Playwright tests 将显示错误消息、预期结果和实际结果以及调用日志。
查看跟踪
您可以上传在 CI(如 GitHub Actions)上作为 artifacts 创建的跟踪。这需要启动和停止跟踪。我们建议只为失败的测试记录跟踪。将跟踪上传到 CI 后,可以使用 trace.playwright.dev 下载并打开它们,trace.playwright.dev 是跟踪查看器的静态托管版本。您可以使用拖放方式上传跟踪文件。