如何在Playwright/TypeScript测试中用Fixture遍历CSV记录

你当前的问题核心在于：Fixture是测试运行阶段才会初始化的，而动态测试需要在测试定义阶段（文件加载时）就拿到数据源，所以直接在Fixture里返回整个records数组无法用来生成动态测试用例。下面提供两种可行的解决方案：

方案一：顶层解析CSV，直接遍历生成测试 #

直接在测试文件的顶层解析CSV数据，然后遍历每条记录生成独立测试用例，这是最直接的方式：

// 测试文件（比如：csv-tests.spec.ts）
import test from './your-fixture-path'; // 导入你定义的扩展test
import fs from 'fs';
import path from 'path';
import { parse } from 'csv-parse/sync';

// 顶层解析CSV，确保测试定义时就能拿到数据
const csvRecords = parse(
  fs.readFileSync(path.join(process.cwd(), process.env.app_qualys_filename!)),
  { columns: true, skip_empty_lines: true }
);

// 遍历每条记录生成测试
test.describe('CSV驱动的测试集合', () => {
  csvRecords.forEach((record, idx) => {
    // 给测试命名，建议包含记录标识（比如关键字段），方便定位问题
    test(`测试记录 ${idx + 1}: ${record.your_key_column}`, async ({ page }) => {
      // 这里写入你的测试逻辑，使用当前record的数据
      await page.goto('https://your-test-site.com');
      await page.fill('#username-input', record.username);
      await page.fill('#password-input', record.password);
      await page.click('#submit-btn');
      // 添加断言
      await expect(page.locator('.welcome-message')).toContainText(record.full_name);
    });
  });
});

方案二：结合Fixture与test.each传递单条记录 #

如果希望通过Fixture封装记录的获取逻辑，可以先在Fixture顶层解析所有记录，再通过test.each传递单条记录给Fixture：

第一步：修改Fixture文件 #

// fixture.ts
import { test as baseTest } from "@playwright/test";
import fs from "fs";
import path from "path";
import { parse } from "csv-parse/sync";

// 顶层解析所有CSV记录，确保测试定义阶段可访问
export const allCsvRecords = parse(
  fs.readFileSync(path.join(process.cwd(), process.env.app_qualys_filename!)),
  { columns: true, skip_empty_lines: true }
);

// 扩展Fixture，提供当前测试用的单条记录
const test = baseTest.extend<{
  currentRecord: typeof allCsvRecords[0]
}>({
  currentRecord: async ({}, use, testInfo) => {
    // 从测试参数中获取当前记录并注入
    await use(testInfo.parameters.currentRecord);
  },
});

export default test;
export const expect = test.expect;

第二步：在测试文件中生成动态测试 #

// csv-tests.spec.ts
import test, { allCsvRecords } from './fixture';

// 使用test.each遍历所有记录，自动生成测试用例
test.each(allCsvRecords)('测试记录: %p', async ({ page, currentRecord }) => {
  // 使用Fixture注入的currentRecord执行测试
  await page.goto('https://your-test-site.com');
  await page.fill('#email', currentRecord.email);
  // ...其他测试步骤与断言
});

关键说明 #

• 不要在Fixture内部解析整个CSV数组来生成动态测试：Fixture的初始化时机是在每个测试用例运行时，而动态测试需要在测试定义阶段就确定用例数量，所以必须在文件顶层（测试定义之前）完成CSV解析。
• 测试命名最好包含记录的关键信息（比如用户名、ID），这样测试失败时能快速定位到对应的数据记录。

内容的提问来源于stack exchange，提问作者samsuthen