跳到主要内容

设置 CI

简介

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

你将学到

设置 GitHub Actions

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

.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. 1. 克隆你的仓库 2. 安装语言依赖 3. 安装项目依赖并构建 4. 安装 Playwright 浏览器 5. 运行测试

创建仓库并推送到 GitHub

一旦你设置好 GitHub actions 工作流程,那么你所需要做的就是 在 GitHub 上创建仓库 或将你的代码推送到现有仓库。按照 GitHub 上的说明进行操作,并且不要忘记使用 git init 命令初始化一个 git 仓库,以便你可以添加提交推送你的代码。

dotnet repo on github

打开工作流

单击 Actions 选项卡以查看工作流。在这里,你将看到你的测试是否已通过或失败。

opening the workflow

在拉取请求中,你还可以单击 PR 状态检查中的 Details 链接。

pr status checked

查看测试日志

单击工作流运行将显示 GitHub 执行的所有操作,单击 Run Playwright tests 将显示错误消息、预期内容和接收内容以及调用日志。

viewing the test logs

查看跟踪

你可以将 CI(如 GitHub Actions)上创建的跟踪上传为工件。这需要启动和停止跟踪。我们建议仅为失败的测试记录跟踪。一旦你的跟踪已上传到 CI,它们就可以被下载并使用 trace.playwright.dev 打开,这是一个静态托管的跟踪查看器变体。你可以使用拖放上传跟踪文件。

playwright trace viewer

下一步