自动化测试 / 系统课时

加载外部测试数据

加载外部测试数据

当测试数据开始由非开发人员维护、需要批量更新,或同一套用例要消费不同数据源时,应把参数从测试代码中移出。本节用 JSON 和 CSV 两种常见格式读取数据,再生成独立的 Playwright 测试,并说明配置型数据该放在哪里。

学习目标

  • 从 JSON 和 CSV 文件读取测试参数
  • 将外部数据转换为可生成 Playwright 用例的对象数组
  • 识别文件路径、数据格式和敏感配置的常见边界

选择合适的数据来源

JSON 适合层级清晰、字段类型较丰富的数据,Node.js 可直接读取并交给 JSON.parse()。CSV 更适合表格维护和大量扁平记录,但解析时要正确处理引号、逗号和空行,实际项目应使用成熟解析库,不要用简单的 split(',') 代替。

环境地址、账号入口、功能开关等“运行配置”通常不应和大量业务样例混在 CSV 中。它们更适合放在 Playwright 配置、环境变量或专门的配置文件里,再由测试数据只描述场景输入与期望结果。

准备 JSON 与 CSV 数据

先安装用于解析 CSV 的依赖:

bash
npm install -D csv-parse

预期输出

text
added <VALUE> packages, and audited <VALUE> packages in <TIME>

<VALUE> 和 <TIME> 取决于当前依赖树与 npm 版本。

创建 tests/data/login-cases.json:

json
[
  {
    "name": "管理员登录成功",
    "username": "admin",
    "password": "p@ss",
    "expected": "WELCOME"
  },
  {
    "name": "密码错误",
    "username": "admin",
    "password": "wrong",
    "expected": "DENIED"
  }
]

再创建 tests/data/login-cases.csv:

text
name,username,password,expected
访客账号拒绝,guest,guest,DENIED
空密码拒绝,admin,,DENIED

这两个文件都只保存测试参数,不包含页面操作。测试逻辑仍集中在一个 .spec.ts 文件中,后续修改交互步骤时不需要同步改数据文件。

读取文件并生成测试

下面的测试在 Node.js 侧读取两个文件,再把每条记录声明成独立测试。__dirname 让路径相对于当前测试文件解析,避免从不同工作目录启动命令时找不到数据。

ts
import fs from 'fs';
import path from 'path';
import { parse } from 'csv-parse/sync';
import { test, expect } from '@playwright/test';

type LoginCase = {
  name: string;
  username: string;
  password: string;
  expected: string;
};

const jsonPath = path.join(__dirname, 'data', 'login-cases.json');
const csvPath = path.join(__dirname, 'data', 'login-cases.csv');

const jsonCases = JSON.parse(
  fs.readFileSync(jsonPath, 'utf-8')
) as LoginCase[];

const csvCases = parse(
  fs.readFileSync(csvPath, 'utf-8'),
  { columns: true, skip_empty_lines: true, trim: true }
) as LoginCase[];

const sources = [
  { name: 'json', cases: jsonCases },
  { name: 'csv', cases: csvCases },
];

for (const source of sources) {
  for (const item of source.cases) {
    test(`${source.name}:${item.name}`, async ({ page }) => {
      await page.setContent(`
        <label>用户名 <input id="username"></label>
        <label>密码 <input id="password" type="password"></label>
        <button id="login">登录</button>
        <p id="message"></p>
        <script>
          document.getElementById('login').addEventListener('click', () => {
            const username = document.getElementById('username').value;
            const password = document.getElementById('password').value;
            document.getElementById('message').textContent =
              username === 'admin' && password === 'p@ss'
                ? 'WELCOME'
                : 'DENIED';
          });
        </script>
      `);

      await page.getByLabel('用户名').fill(item.username);
      await page.getByLabel('密码').fill(item.password);
      await page.getByRole('button', { name: '登录' }).click();
      await expect(page.locator('#message')).toHaveText(item.expected);
    });
  }
}

执行测试:

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

预期输出

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

这里的数量按单一 Playwright 项目计算;如果配置了多个 projects,每个项目都会重复执行这 4 条测试。

处理外部数据的失败边界

外部数据会把一部分错误提前到“测试发现”阶段。文件不存在、JSON 语法错误、CSV 表头拼错,都可能导致测试文件加载失败,甚至还没进入 test()。因此数据文件应和测试代码一起纳入版本控制,并在代码评审中检查字段变更。

类型断言 as LoginCase[] 只帮助 TypeScript 理解代码,并不会在运行时验证文件内容。对来自运营平台、下载文件或其他不可信来源的数据,最好增加运行时校验,确保 name、输入字段和 expected 均存在且类型正确,再生成测试。

敏感值也不应直接写进 JSON 或 CSV 并提交仓库。密码、令牌和环境专属凭据应通过环境变量或密钥管理系统注入;外部测试数据只保留可公开的场景参数。这样既保留了数据驱动的可维护性,也不会把配置管理和测试样例混成一层。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载外部测试数据

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

登录哪都通