自动化测试 / 系统课时
创建自定义 Fixture
创建自定义 Fixture
当账号、页面对象和测试数据在多条用例中反复出现时,可以用 test.extend() 把它们变成可组合的 Fixture。目标不是隐藏所有代码,而是让测试正文只声明所需依赖,并让创建与清理在固定位置完成。
学习目标
- 使用
test.extend()声明带类型的自定义 Fixture - 组合账号、页面对象和测试数据之间的依赖关系
- 为不同依赖选择合适作用域并保留清理逻辑
先按生命周期划分依赖
自定义 Fixture 适合封装“有生命周期的公共依赖”。页面对象通常依赖每条测试独立的 page,因此用 test 作用域;测试数据也常按测试生成。账号若创建成本较高且允许同一 worker 复用,可以设为 worker 作用域。
下面的示例故意不依赖外部站点:账号 Fixture 生成一个 worker 内稳定的测试身份,页面对象通过 page.setContent() 构造最小页面,测试数据再从账号派生预期文案。真实项目只需要把账号创建和清理替换成自己的 API 调用。
用 test.extend() 组合三个 Fixture
把下面文件保存为 tests/custom-fixture.spec.ts。示例完整展示 worker Fixture 的类型声明、test Fixture 的依赖注入,以及 teardown 的放置位置。
import { test as base, expect, type Page } from '@playwright/test';
type Account = {
username: string;
};
type TestFixtures = {
dashboard: DashboardPage;
testData: { welcomeText: string };
};
type WorkerFixtures = {
account: Account;
};
class DashboardPage {
constructor(
private readonly page: Page,
private readonly account: Account,
) {}
async open() {
await this.page.setContent(
`<main><h1>Welcome, ${this.account.username}</h1></main>`,
);
}
heading() {
return this.page.getByRole('heading', { level: 1 });
}
}
const test = base.extend<TestFixtures, WorkerFixtures>({
account: [
async ({}, use, workerInfo) => {
const account = { username: `user-${workerInfo.workerIndex}` };
console.log(`create account: ${account.username}`);
// 真实项目可在这里调用 API 创建账号,并在 use() 后删除。
await use(account);
console.log(`cleanup account: ${account.username}`);
},
{ scope: 'worker' },
],
dashboard: async ({ page, account }, use) => {
const dashboard = new DashboardPage(page, account);
await dashboard.open();
await use(dashboard);
},
testData: async ({ account }, use) => {
await use({ welcomeText: `Welcome, ${account.username}` });
},
});
test('uses custom fixtures', async ({ dashboard, testData }) => {
await expect(dashboard.heading()).toHaveText(testData.welcomeText);
});运行测试:
npx playwright test tests/custom-fixture.spec.ts --workers=1预期输出会包含下面两条生命周期日志,<ID> 对应实际的 workerInfo.workerIndex,具体值可能不同;测试报告器还会输出用例结果:
create account: user-<ID>
cleanup account: user-<ID>这里 dashboard 和 testData 都依赖 account,而 dashboard 还依赖内置 page。测试只声明 dashboard 与 testData,运行器会沿依赖关系自动准备 account 和 page。

类型参数要把两种作用域分开
base.extend<TestFixtures, WorkerFixtures>() 的第一个泛型参数描述 test 作用域 Fixture,第二个描述 worker 作用域 Fixture。这样 TypeScript 能检查测试函数参数,也能阻止把不存在的 Fixture 名称写进用例。
worker Fixture 使用 [factory, options] 元组才能设置 scope: 'worker'。普通对象形式默认就是 test 作用域,不需要重复声明 scope: 'test'。
清理逻辑紧跟在 use() 之后
Fixture 自己创建的远端账号、临时文件、数据库记录或额外浏览器资源,应把回收逻辑放在 await use(...) 之后。测试无论成功还是失败,运行器都会进入 Fixture 的 teardown 阶段;worker Fixture 则在该 worker 结束时再清理。
不要重复关闭内置 page 或 context,它们由 Playwright 管理。只有当 Fixture 自己额外创建了资源,例如通过 browser.newContext() 建立独立上下文时,才应由该 Fixture 对称地关闭它。
Fixture 与普通 helper 的边界
无状态的字符串转换、数据计算或断言封装通常继续写成普通函数即可。需要运行器参与生命周期管理、依赖解析、作用域复用或自动清理时,再提升为 Fixture。
一个实用判断是:如果测试需要“声明我需要什么”,而不应该关心“它怎么准备和怎么回收”,这类依赖就很适合放进自定义 Fixture。