跳到主要内容

设置 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: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.11'
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Ensure browsers are installed
      run: python -m playwright install --with-deps
    - name: Run your tests
      run: pytest --tracing=retain-on-failure
    - uses: actions/upload-artifact@v4
      if: ${{ !cancelled() }}
      with:
        name: playwright-traces
        path: test-results/

要了解更多信息，请参阅“理解 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 执行的所有操作，点击“Run Playwright tests”会显示错误消息、预期结果和实际结果以及调用日志。

​

Viewing Test Logs

查看跟踪​

trace.playwright.dev 是跟踪查看器的一个静态托管变体。你可以使用拖放功能上传跟踪文件。

playwright trace viewer

下一步​