Playwright API测试：能否循环使用不同Fixture执行同一测试？

我正在使用Playwright进行API测试，原本为不同用户类型（Administrator、PowerUser、User）分别定义了APIRequestContext类型的Fixture，代码如下：

import { APIRequestContext, test as baseTest } from '@playwright/test';
import { apiLogin } from 'apiLogin';

type ApiLoginFixtures = {
  Administrator: APIRequestContext;
  PowerUser: APIRequestContext;
  User: APIRequestContext;
};

export const test = baseTest.extend<ApiLoginFixtures>({
  Administrator: async ({}, use) => {
    const context = await apiLogin('ADMINISTRATOR');
    await use(context);
    await context.dispose();
  },

  PowerUser: async ({}, use) => {
    const context = await apiLogin('POWERUSER');
    await use(context);
    await context.dispose();
  },

  User: async ({}, use) => {
    const context = await apiLogin('USER');
    await use(context);
    await context.dispose();
  },
});

我可以在测试中直接调用这些上下文，例如await PowerUser.get('/some/endpoint');。

但我希望编写单个测试，循环遍历所有用户类型对应的Fixture来执行。我尝试了以下方法但无法生效：

Fixture文件修改：

// Fixture file
export const test = baseTest.extend<ApiLoginFixtures>({
  UserFixture: {} as APIRequestContext,

  Administrator: async ({}, use) => {
    const context = await apiLogin('ADMINISTRATOR');
    await use(context);
    await context.dispose();
  },

  // [...] PowerUser, etc.
});

测试文件代码：

// Test file
let fixtures: {name: string, theFixture: APIRequestContext}[] = [];

test.beforeAll(async ({ Administrator, PowerUser }) => {
  fixtures.push(
    {name: 'Administrator', theFixture: Administrator},
    {name: 'PowerUser', theFixture: PowerUser},
  )
});

for (const {name, theFixture} of fixtures) {
  test.describe(`Test suite for some/endpoint`, async () => {
    test.use({UserFixture: theFixture});
    test(`GET some/endpoint as ${name}`, { tag: '@someTag' }, async ({ UserFixture }) => {
      const response = await UserFixture.get('/some/endpoint');
      expect(response.status()).toBe(200);
    });
  });
}

请问是否有可行的解决方案？还是我需要重构用户登录的处理方式？

方案一：直接循环用户类型动态生成测试（无需修改原Fixture） #

Playwright的测试注册是静态的，不能在beforeAll之后再动态生成测试（beforeAll是运行时执行，而测试定义在文件加载阶段就已完成）。你可以直接定义用户类型数组，循环数组生成对应测试：

测试文件代码：

import { test } from './your-fixture-file';

// 定义要测试的用户类型列表
const userTypes = [
  { name: 'Administrator' },
  { name: 'PowerUser' },
  { name: 'User' },
];

// 循环生成测试
test.describe(`Test suite for /some/endpoint`, () => {
  for (const { name } of userTypes) {
    test(`GET /some/endpoint as ${name}`, { tag: '@someTag' }, async ({ [name]: userContext }) => {
      const response = await userContext.get('/some/endpoint');
      expect(response.status()).toBe(200);
    });
  }
});

这里通过对象解构动态获取对应Fixture，直接复用你原有的三个Fixture，不需要额外修改Fixture文件。

方案二：重构Fixture为参数化版本（更简洁易维护） #

如果后续用户类型可能增加，重构Fixture成参数化方式会更高效：

1. 修改Fixture文件 #

import { APIRequestContext, test as baseTest } from '@playwright/test';
import { apiLogin } from 'apiLogin';

type ApiFixtures = {
  userContext: APIRequestContext;
  userRole: string;
};

// 扩展基础测试，添加参数化的userContext
export const test = baseTest.extend<ApiFixtures>({
  // 定义默认角色，测试时可覆盖
  userRole: ['USER', { option: true }],
  userContext: async ({ userRole }, use) => {
    const context = await apiLogin(userRole);
    await use(context);
    await context.dispose();
  },
});

2. 测试文件中循环调用 #

import { test } from './your-fixture-file';

const userTypes = [
  { name: 'Administrator', role: 'ADMINISTRATOR' },
  { name: 'PowerUser', role: 'POWERUSER' },
  { name: 'User', role: 'USER' },
];

test.describe(`Test suite for /some/endpoint`, () => {
  for (const { name, role } of userTypes) {
    test(`GET /some/endpoint as ${name}`, { tag: '@someTag' }, async ({ userContext }) => {
      const response = await userContext.get('/some/endpoint');
      expect(response.status()).toBe(200);
    }).use({ userRole: role }); // 覆盖默认角色
  }
});

这种方式只需要维护一个userContext Fixture，新增用户类型时仅需在数组中添加条目即可，扩展性更强。

原方法失效原因 #

你的原代码中，fixtures数组是在beforeAll中填充的，但Playwright的测试定义（test()、test.describe()）在文件加载阶段就已解析完成，beforeAll是运行时才执行，此时循环遍历空数组不会生成任何测试，因此没有效果。

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