自动化测试 / 系统课时

编写参数化测试

编写参数化测试

当同一条业务规则需要验证多组输入时,不必复制多份测试。参数化测试把“变化的数据”和“稳定的操作步骤”分开,让每一行数据生成一个可独立报告、失败和重试的 Playwright 用例。

学习目标

  • 使用数据数组批量声明结构一致的 Playwright 测试
  • 为每组数据设计唯一、可定位的测试名称
  • 避免参数化测试中的共享状态和 Hook 作用域问题

把变化收进数据表

参数化的核心不是在一个 test() 里循环多组数据,而是在测试文件加载时,根据数据逐个声明 test()。这样 Playwright 能把每组参数视为独立用例:某一组失败时,报告会直接指出对应名称,重试也只针对失败用例。

下面用一个无需外部服务的页面演示。三组输入都执行相同的“填写、点击、断言”,只有输入值和期望值不同。

ts
import { test, expect } from '@playwright/test';

type NormalizeCase = {
  name: string;
  input: string;
  expected: string;
};

const cases: NormalizeCase[] = [
  { name: '普通文本', input: 'alice', expected: 'ALICE' },
  { name: '首尾空格', input: '  bob  ', expected: 'BOB' },
  { name: '字母与数字', input: 'user01', expected: 'USER01' },
];

for (const item of cases) {
  test(`用户名规范化:${item.name}`, async ({ page }) => {
    await page.setContent(`
      <label>用户名 <input id="name"></label>
      <button id="normalize">转换</button>
      <p id="result"></p>
      <script>
        document.getElementById('normalize').addEventListener('click', () => {
          const input = document.getElementById('name');
          document.getElementById('result').textContent =
            input.value.trim().toUpperCase();
        });
      </script>
    `);

    await page.getByLabel('用户名').fill(item.input);
    await page.getByRole('button', { name: '转换' }).click();
    await expect(page.locator('#result')).toHaveText(item.expected);
  });
}

保存为 tests/parameterized.spec.ts 后执行:

bash
npx playwright test tests/parameterized.spec.ts --workers=1 --reporter=line

预期输出

text
Running 3 tests using 1 worker
3 passed (<TIME>)

<TIME> 会随机器性能变化。如果项目配置了多个 projects,同一批用例会按项目重复执行,因此通过数量也会相应增加。

让测试名称能定位数据

参数化后,测试名称就是最重要的诊断入口。名称应包含业务含义稳定、能区分数据行的字段,例如场景名、角色或输入类别,而不是只写数组下标。否则报告里出现“case 2 failed”时,还要回头查第二行数据才能知道失败场景。

还要保证生成后的名称唯一。即使 Playwright 能发现重复声明,重复名称也会让报告、筛选和失败沟通变得含糊。数据里最好显式保存 name 或 id,再把它拼进 test() 名称。

控制 Hook 与共享状态

通常把 beforeEach、afterEach 等 Hook 放在数据循环外,让每个参数化用例都执行同一套初始化与清理。如果某组数据确实需要专属 Hook,可以在该次迭代里创建独立的 test.describe() 作用域,再在作用域内声明 Hook 和测试。

不要让不同数据行修改同一个全局可变对象、共用同一账号中的不可重复资源,或依赖前一条测试留下的状态。参数化只复用了测试结构,并没有改变 Playwright 对测试隔离和并行执行的要求。

参数化测试与项目参数化的边界

业务输入变化,例如用户名、搜索词、权限角色、表单组合,优先使用本节这种“数据行生成测试”的方式。浏览器、设备、语言、环境地址等运行环境变化,更适合放进 Playwright projects 或配置层。

当每条数据都能对应一个清晰的测试名称,并且任意一条都可以单独运行、失败和重试时,参数化测试才真正实现了复用,而不是把多组断言塞进一个更难定位的大测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写参数化测试

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

登录哪都通