自动化测试 / 系统课时
加载外部测试数据
加载外部测试数据
当测试数据开始由非开发人员维护、需要批量更新,或同一套用例要消费不同数据源时,应把参数从测试代码中移出。本节用 JSON 和 CSV 两种常见格式读取数据,再生成独立的 Playwright 测试,并说明配置型数据该放在哪里。
学习目标
- 从 JSON 和 CSV 文件读取测试参数
- 将外部数据转换为可生成 Playwright 用例的对象数组
- 识别文件路径、数据格式和敏感配置的常见边界
选择合适的数据来源
JSON 适合层级清晰、字段类型较丰富的数据,Node.js 可直接读取并交给 JSON.parse()。CSV 更适合表格维护和大量扁平记录,但解析时要正确处理引号、逗号和空行,实际项目应使用成熟解析库,不要用简单的 split(',') 代替。
环境地址、账号入口、功能开关等“运行配置”通常不应和大量业务样例混在 CSV 中。它们更适合放在 Playwright 配置、环境变量或专门的配置文件里,再由测试数据只描述场景输入与期望结果。
准备 JSON 与 CSV 数据
先安装用于解析 CSV 的依赖:
npm install -D csv-parse预期输出
added <VALUE> packages, and audited <VALUE> packages in <TIME><VALUE> 和 <TIME> 取决于当前依赖树与 npm 版本。
创建 tests/data/login-cases.json:
[
{
"name": "管理员登录成功",
"username": "admin",
"password": "p@ss",
"expected": "WELCOME"
},
{
"name": "密码错误",
"username": "admin",
"password": "wrong",
"expected": "DENIED"
}
]再创建 tests/data/login-cases.csv:
name,username,password,expected
访客账号拒绝,guest,guest,DENIED
空密码拒绝,admin,,DENIED这两个文件都只保存测试参数,不包含页面操作。测试逻辑仍集中在一个 .spec.ts 文件中,后续修改交互步骤时不需要同步改数据文件。
读取文件并生成测试
下面的测试在 Node.js 侧读取两个文件,再把每条记录声明成独立测试。__dirname 让路径相对于当前测试文件解析,避免从不同工作目录启动命令时找不到数据。
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);
});
}
}执行测试:
npx playwright test tests/external-data.spec.ts --workers=1 --reporter=line预期输出
Running 4 tests using 1 worker
4 passed (<TIME>)这里的数量按单一 Playwright 项目计算;如果配置了多个 projects,每个项目都会重复执行这 4 条测试。
处理外部数据的失败边界
外部数据会把一部分错误提前到“测试发现”阶段。文件不存在、JSON 语法错误、CSV 表头拼错,都可能导致测试文件加载失败,甚至还没进入 test()。因此数据文件应和测试代码一起纳入版本控制,并在代码评审中检查字段变更。
类型断言 as LoginCase[] 只帮助 TypeScript 理解代码,并不会在运行时验证文件内容。对来自运营平台、下载文件或其他不可信来源的数据,最好增加运行时校验,确保 name、输入字段和 expected 均存在且类型正确,再生成测试。
敏感值也不应直接写进 JSON 或 CSV 并提交仓库。密码、令牌和环境专属凭据应通过环境变量或密钥管理系统注入;外部测试数据只保留可公开的场景参数。这样既保留了数据驱动的可维护性,也不会把配置管理和测试样例混成一层。