设置持续集成（CI）

简介

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

你将学到

• 如何设置 GitHub Actions
• 如何查看测试日志
• 如何查看追踪信息

设置 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
    - uses: actions/setup-java@v3
      with:
        distribution: 'temurin'
        java-version: '17'
    - name: Build & Install
      run: mvn -B install -D skipTests --no-transfer-progress
    - name: Ensure browsers are installed
      run: mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --with-deps"
    - name: Run tests
      run: mvn test

要了解更多相关内容，请参阅 "理解 GitHub Actions"。

查看 jobs.test.steps 中的步骤列表，你可以看到该工作流程执行以下步骤：

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

创建仓库并推送到 GitHub

设置好 GitHub 操作工作流程 后，你需要做的就是 在 GitHub 上创建一个仓库，或者将代码推送到现有仓库。按照 GitHub 上的说明操作，别忘了使用 git init 命令 初始化一个 Git 仓库，这样你就可以 添加、提交 和 推送 代码。

打开工作流程

点击 操作 选项卡查看工作流程。在这里你可以看到测试是否通过。

查看测试日志

点击工作流程运行，会显示 GitHub 执行的所有操作，点击 运行 Playwright 测试 会显示错误消息、预期结果、实际结果以及调用日志。

查看追踪信息

trace.playwright.dev 是追踪查看器的静态托管版本。你可以通过拖放上传追踪文件。

妥善处理机密信息

诸如跟踪文件或控制台日志之类的工件包含有关测试执行的信息。它们可能包含敏感数据，例如测试用户的用户凭据、暂存后端的访问令牌、测试源代码，有时甚至是应用程序源代码。对待这些文件要像对待敏感数据一样谨慎。如果在 CI 工作流程中上传报告和跟踪文件，请确保仅将它们上传到可信任的工件存储中，或者在上传之前对文件进行加密。与团队成员共享工件时也是如此：使用可信任的文件共享方式，或者在共享之前对文件进行加密。

接下来是什么

• 了解如何使用定位器
• 了解如何执行操作
• 了解如何编写断言
• 详细了解跟踪查看器
• 了解在 GitHub Actions 上运行测试的更多方法
• 详细了解在其他 CI 提供商上运行测试的方法