自动化测试 / 系统课时

接入持续集成流程

接入持续集成流程

将 Playwright 接入持续集成后,每次提交或合并请求都可以在干净环境中重新安装依赖、准备浏览器、执行端到端测试,并保存失败证据和测试报告。本节以 GitHub Actions 为例搭建一条可直接运行的基础流水线。

学习目标

  • 在 CI 中正确安装 Node.js 依赖和 Playwright 浏览器依赖
  • 在代码推送和合并请求时自动执行 Playwright 测试
  • 无论测试成功还是失败,都保留可供排查的 HTML 报告

明确流水线需要完成什么

一条最小可用的 Playwright CI 流程应依次完成代码检出、Node.js 环境准备、依赖安装、浏览器及系统依赖安装、测试执行和报告保存。CI Runner 通常是临时环境,因此不能假设浏览器或 node_modules 已经存在。

Playwright 持续集成执行流程

为了确保流水线能产生 HTML 报告,可以在项目的 playwright.config.ts 中显式配置 reporter:

ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [['html', { open: 'never' }]],
  retries: process.env.CI ? 2 : 0,
  workers: process.env.CI ? 1 : undefined,
});

这段配置在 CI 中允许失败测试最多重试两次,并使用单 worker 获得更保守的执行稳定性。是否增加 worker 应根据 Runner 资源和测试隔离情况单独评估,而不是直接复制固定数值。

创建 GitHub Actions 工作流

在仓库中创建 .github/workflows/playwright.yml。下面的工作流会在 main 分支收到 push 或 pull request 时执行测试,并在结束后上传 playwright-report:

yaml
name: Playwright Tests

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 60

    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: lts/*
          cache: npm

      - name: Install dependencies
        run: npm ci

      - name: Install Playwright browsers
        run: npx playwright install --with-deps

      - name: Run Playwright tests
        run: npx playwright test

      - name: Upload Playwright report
        if: ${{ !cancelled() }}
        uses: actions/upload-artifact@v5
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 30

这里使用 npm ci 而不是普通的 npm install,前提是仓库已经提交与 package.json 匹配的锁文件。npx playwright install --with-deps 同时准备浏览器和 Linux Runner 所需的系统依赖。

在本地验证 CI 的核心命令

提交工作流前,至少先确认项目自身能够通过同一条测试命令。这样可以把“测试本身失败”和“CI 配置错误”分开处理:

bash
npx playwright test

预期输出

text
Running <N> tests using <N> worker(s)
...
<N> passed (<TIME>)

实际测试数量、worker 数量和耗时会随项目配置变化。命令成功时进程退出码应为 0;存在最终未通过的测试时,CI Job 会因非零退出码而失败。

保留失败证据并检查流水线

测试失败并不意味着报告上传步骤也应该跳过。工作流中的 if: ${{ !cancelled() }} 允许前面的测试步骤失败后继续上传报告,但在整个工作流被主动取消时不再执行该步骤。这样既保留测试 Job 的失败状态,也能获得排查材料。

首次接入后应检查三个结果:成功用例能够让 Job 通过;故意制造断言失败时 Job 会变红;失败运行仍能在该次流水线的 Artifacts 中看到 playwright-report。下载并解压报告后,可以在具有 Playwright 项目依赖的环境中查看:

bash
npx playwright show-report <PATH>

预期结果

text
Serving HTML report at http://localhost:<PORT>

<PATH> 是解压后的报告目录,<PORT> 由实际运行环境决定。浏览器打开对应地址后,应能查看测试状态和失败详情。

当本地命令、CI 退出状态和报告保存三者都符合预期后,这条流水线才算形成完整闭环:提交触发测试,失败能够阻止错误变更悄悄通过,同时留下足够的证据供后续定位。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入持续集成流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通