Playwright数据驱动测试：从Excel和JSON读取测试数据

关注 霍格沃兹测试学院公众号，回复「资料」, 领取人工智能测试开发技术合集

如果你还在为每个测试用例硬编码数据而头疼，或者每次数据变更都要翻遍几十个测试文件——是时候了解数据驱动测试了。今天，我们聊聊如何用 Playwright 优雅地从 Excel 和 JSON 文件中读取测试数据，让你的测试代码真正实现“一次编写，到处运行”。

为什么需要数据驱动测试？
先看个反例。假设我们要测试一个登录功能，传统写法可能是：

test('用户登录测试', async ({ page }) => {
await page.fill('#username', 'zhangsan');
await page.fill('#password', '123456');
await page.click('#login-btn');
// 断言...
});

test('管理员登录测试', async ({ page }) => {
await page.fill('#username', 'admin');
await page.fill('#password', 'admin@123');
await page.click('#login-btn');
// 断言...
});
发现问题了吗？每增加一个测试账户，就要复制粘贴一整段代码。当密码策略变化时，你得修改所有相关测试文件。这种维护成本，你懂的。

而数据驱动测试的思想很简单：分离测试逻辑与测试数据。我们的目标是把上面的代码改造成这样：

// 测试逻辑只有一份
test('登录功能测试', async ({ page }) => {
const testData = getTestData(); // 从外部文件读取
for (const data of testData) {
await performLogin(page, data);
// 断言...
}
});
接下来，我们看看具体怎么实现。

实战一：从 Excel 读取测试数据
Excel 可能是产品经理和业务人员最喜欢的数据格式。如果你的测试数据需要经常让非技术人员维护，Excel 是个不错的选择。

第一步：准备测试数据
创建一个 testdata.xlsx 文件，内容如下：

notexists
123456
提示用户不存在
保存到项目目录的 data/ 文件夹下。

第二步：安装必要的包
Playwright 本身不处理 Excel，我们需要借助社区包：

npm install xlsx

或者

yarn add xlsx
第三步：实现 Excel 读取工具
创建 utils/excelReader.js：

const XLSX = require('xlsx');
const path = require('path');

class ExcelReader {
/**

• 读取Excel文件

• @param {string} filePath - Excel文件路径

• @param {string} sheetName - 工作表名称（可选，默认为第一个）

• @returns {Array} 测试数据数组
  */
  static readTestData(filePath, sheetName = null) {
  try {
  // 解析文件路径
  const absolutePath = path.resolve(__dirname, '..', filePath);

  // 读取工作簿
  const workbook = XLSX.readFile(absolutePath);

  // 获取工作表
  const sheet = sheetName
  ? workbook.Sheets[sheetName]
  : workbook.Sheets[workbook.SheetNames[0]];

  if (!sheet) {
  thrownewError(工作表 ${sheetName || '第一个'} 不存在);
  }

  // 转换为JSON
  const jsonData = XLSX.utils.sheet_to_json(sheet);

  console.log(成功从 ${filePath} 读取 ${jsonData.length} 条测试数据);
  return jsonData;

} catch (error) {
  console.error('读取Excel文件失败:', error.message);
  throw error;
}

}

/**

• 按测试场景筛选数据
• @param {string} filePath - Excel文件路径
• @param {string} scenario - 测试场景名称
  */
  static getDataByScenario(filePath, scenario) {
  const allData = this.readTestData(filePath);
  return allData.filter(row => row['测试场景'] === scenario);
  }
  }

module.exports = ExcelReader;
第四步：在测试中使用
现在，让我们重写登录测试：

const { test, expect } = require('@playwright/test');
const ExcelReader = require('../utils/excelReader');

test.describe('登录功能数据驱动测试', () => {
let testData;

test.beforeAll(() => {
// 一次性读取所有测试数据
testData = ExcelReader.readTestData('./data/testdata.xlsx');
console.log(本次执行将运行 ${testData.length} 个测试用例);
});

test('数据驱动登录测试', async ({ page }) => {
// 遍历每条测试数据
for (const data of testData) {
// 使用测试场景作为子测试名称
await test.step(测试场景: ${data['测试场景']}, async () => {
console.log(执行用例: ${data['测试场景']}, 用户名: ${data.username});

    // 导航到登录页
    await page.goto('https://your-app.com/login');
    
    // 使用数据填充表单
    await page.fill('#username', data.username);
    await page.fill('#password', data.password);
    await page.click('#login-btn');
    
    // 根据预期结果进行断言
    if (data.expected_result === '登录成功') {
      await expect(page).toHaveURL('https://your-app.com/dashboard');
      await expect(page.locator('.welcome-message')).toContainText(data.username);
    } elseif (data.expected_result.includes('提示')) {
      await expect(page.locator('.error-message')).toBeVisible();
      await expect(page.locator('.error-message')).toContainText(data.expected_result);
    }
    
    // 如果是管理员登录的特殊断言
    if (data.username === 'admin' && data.expected_result === '跳转管理后台') {
      await expect(page).toHaveURL('https://your-app.com/admin');
    }
  });
}

});
});
Excel 方案的优缺点
优点：

非技术人员也能轻松维护
支持复杂的数据格式（合并单元格、公式等）
可以用 Excel 的数据验证功能保证数据质量
缺点：

需要额外依赖
版本控制时二进制文件对比困难
读取速度相对较慢
Playwright mcp技术学习交流群
伙伴们，对AI测试、大模型评测、质量保障感兴趣吗？我们建了一个 「Playwright mcp技术学习交流群」，专门用来探讨相关技术、分享资料、互通有无。无论你是正在实践还是好奇探索，都欢迎扫码加入，一起抱团成长！期待与你交流！👇

实战二：从 JSON 读取测试数据
如果你团队里都是开发人员，或者你更喜欢纯文本的版本控制，JSON 可能是更好的选择。

第一步：创建 JSON 数据文件
创建 data/loginTestData.json：

{
"login_cases": [
{
"test_scenario": "普通用户登录",
"username": "zhangsan",
"password": "123456",
"expected_result": "登录成功",
"permissions": ["view", "edit"],
"metadata": {
"priority": "P0",
"tags": ["smoke", "regression"]
}
},
{
"test_scenario": "管理员登录",
"username": "admin",
"password": "admin@123",
"expected_result": "跳转管理后台",
"permissions": ["view", "edit", "delete", "admin"],
"metadata": {
"priority": "P1",
"tags": ["regression"]
}
},
{
"test_scenario": "密码错误",
"username": "lisi",
"password": "wrong_pwd",
"expected_result": "提示密码错误",
"metadata": {
"priority": "P2",
"tags": ["negative"]
}
}
],
"environment_config": {
"base_url": "https://your-app.com",
"timeout": 30000
}
}
第二步：创建 JSON 读取工具
创建 utils/jsonReader.js：

const fs = require('fs').promises;
const path = require('path');

class JsonReader {
/**

• 读取JSON测试数据

• @param {string} filePath - JSON文件路径

• @returns {Promise