跳转到主要内容

设置 CI

简介

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

你将学到

设置 GitHub Actions

要添加 GitHub Actions 文件,首先创建 .github/workflows 文件夹,并在其中添加一个 playwright.yml 文件,其中包含以下示例代码,以便您的测试在主/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 Actions 工作流,您所需要做的就是 在 GitHub 上创建存储库 或将您的代码推送到现有存储库。按照 GitHub 上的说明操作,并且不要忘记使用 git init 命令 初始化 git 存储库,以便您可以 添加提交推送 您的代码。

Create a Repo and Push to GitHub

打开工作流

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

opening the workflow

查看测试日志

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

Viewing Test Logs

查看跟踪

trace.playwright.dev 是 Trace Viewer 的静态托管版本。您可以使用拖放上传跟踪文件。

正确处理秘密

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

接下来