跳转到主要内容

设置 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

查看 Trace​

您可以将 CI（如 GitHub Actions）上创建的 Trace 作为工件上传。这需要启动和停止 Trace。我们建议仅为失败的测试记录 Trace。一旦您的 Trace 已上传到 CI，它们就可以下载并使用 trace.playwright.dev 打开，这是一个静态托管的 Trace Viewer 变体。您可以使用拖放上传 trace 文件。

​

playwright trace viewer

下一步​