自动化测试 / 系统课时
规划综合测试项目
规划综合测试项目
综合测试项目最容易失败的地方不是不会写脚本,而是范围、环境和验收标准没有先对齐。本节把需求收敛为可执行的测试计划,最终得到浏览器矩阵、账号角色、数据策略和交付门槛,并用 Playwright 配置验证计划确实能落地。
学习目标
- 划定端到端测试的核心范围与暂不覆盖范围
- 设计浏览器、账号角色和测试数据矩阵
- 把交付标准写进 Playwright 配置并完成可执行验证
先把测试范围压缩到可交付
综合项目不应从“把所有页面都自动化”开始,而应先选择能够证明系统主链路可用的少量场景。对一个常见管理系统,可以把首批范围限定为登录、查询、新增、修改、删除,并明确支付、第三方短信、复杂权限审批等暂不纳入。
范围判断可以围绕三个问题:这条链路是否直接影响核心业务、失败后是否会阻断用户完成任务、是否适合通过浏览器稳定验证。只要答案大多为“是”,它就适合作为端到端测试的首批对象。
设计浏览器与角色矩阵
浏览器矩阵应反映真实用户分布,而不是机械地把所有浏览器都跑一遍。常见做法是把 Chromium 作为主回归浏览器,再用 Firefox 和 WebKit 覆盖兼容性风险。账号也应按权限角色拆分,例如管理员负责增删改,普通用户只验证查询和只读能力。
可以先用一张小表固定第一版边界:
| 维度 | 首批选择 | 目的 |
|---|---|---|
| 浏览器 | Chromium、Firefox、WebKit | 覆盖主流渲染引擎 |
| 角色 | admin、viewer | 覆盖写权限与只读权限 |
| 数据 | 每次测试独立创建 | 避免用例之间互相污染 |
| 运行方式 | 本地冒烟 + CI 全量 | 兼顾反馈速度与覆盖面 |
当角色和浏览器组合过多时,不要直接做全笛卡尔积。先让关键写操作在 Chromium 上稳定,再把登录和查询类用例扩展到全部浏览器。
把计划写进 Playwright 配置
下面的 playwright.config.ts 把三种浏览器、失败保留 Trace、CI 禁止 test.only 等交付规则固化下来。示例假设被测系统运行在 http://127.0.0.1:3000。
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './tests/e2e',
fullyParallel: true,
forbidOnly: !!process.env.CI,
retries: process.env.CI ? 2 : 0,
reporter: [['list'], ['html', { open: 'never' }]],
use: {
baseURL: 'http://127.0.0.1:3000',
trace: 'retain-on-failure',
screenshot: 'only-on-failure',
},
projects: [
{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
],
});配置生效后,使用 Playwright 的测试枚举功能确认项目和测试文件能够被发现:
npx playwright test --list预期输出
Listing tests:
[chromium] › <PATH>:<LINE>:<COLUMN> › <TEST_NAME>
[firefox] › <PATH>:<LINE>:<COLUMN> › <TEST_NAME>
[webkit] › <PATH>:<LINE>:<COLUMN> › <TEST_NAME>
Total: <N> tests in <N> files实际路径、行号和测试数量会随项目内容不同而变化,但输出中应能看到三个 project 名称。
固定账号与测试数据策略
账号和业务数据必须区分“长期基线数据”和“测试过程产生的数据”。角色账号可以长期保留,但订单、商品、用户记录等可变业务数据应在测试中创建,并在测试结束后删除或通过 API、数据库清理。
不要让多个测试共用同一条可修改记录,否则并发执行时很容易出现互相覆盖。更稳妥的做法是为每次运行生成唯一标识,例如 e2e-<ID>,并把该标识写入测试创建的数据名称中,便于定位和清理。
定义交付标准
综合项目完成的判断应提前写清,而不是等脚本写完再讨论。最小交付标准可以包括:核心用例在 Chromium 全部通过,关键登录和查询用例在三种浏览器通过,失败时能拿到 Trace 或截图,CI 不允许 test.only,连续多次运行没有明显偶发失败。
这些标准同时决定后续代码怎么组织:浏览器矩阵来自配置,角色差异来自测试夹具,数据隔离来自创建与清理策略,CI 门槛则来自命令退出码和测试报告。项目规划完成后,后续新增用例都应能明确落到这些约束中,而不是临时决定。