自动化测试 / 系统课时

理解 Fixture 机制

理解 Fixture 机制

Fixture 解决的是“测试依赖由谁创建、何时提供、何时销毁”的问题。理解它后,你就能读懂 page 等内置依赖的来源,并能判断自定义依赖应该按测试创建,还是在同一 worker 内复用。

学习目标

  • 说清 Fixture 的创建、注入、使用和清理顺序
  • 区分 test 作用域与 worker 作用域的生命周期
  • 理解按需执行、依赖顺序与自动 Fixture 的差异

Fixture 本质上是受控的依赖注入

Playwright Test 会先分析测试函数参数中声明的 Fixture,再准备实际需要的依赖。例如测试参数里的 page 不是普通局部变量,而是由运行器创建并注入的内置 Fixture。测试结束后,对应资源会按生命周期规则清理。

Fixture 不只负责“给一个值”。它还把初始化、使用和回收放在同一个定义中,因此比把登录、建数据、清数据散落在 beforeEach、afterEach 和测试正文里更容易维护。

非自动 Fixture 默认按需执行:没有测试或其他 Fixture 依赖它,就不会为了“可能用到”而提前创建。若配置 { auto: true },则会在对应作用域内自动启动。

从 await use() 看完整生命周期

自定义 Fixture 的分界点是 await use(value):它之前是 setup,传给 use 的值会注入测试,use 返回后进入 teardown。把下面文件保存为 tests/fixture-lifecycle.spec.ts。

ts
import { test as base, expect } from '@playwright/test';

const test = base.extend<{ marker: string }>({
  marker: async ({}, use) => {
    console.log('fixture: setup');

    // use() 把值交给测试;它返回后才进入清理阶段。
    await use('ready');

    console.log('fixture: teardown');
  },
});

test('fixture lifecycle', async ({ marker }) => {
  console.log(`test: ${marker}`);
  expect(marker).toBe('ready');
});

运行测试:

bash
npx playwright test tests/fixture-lifecycle.spec.ts --workers=1

预期输出中会按下面顺序出现三行;测试报告器还会打印用例状态等信息:

text
fixture: setup
test: ready
fixture: teardown

这说明测试并不是主动调用 Fixture。运行器先完成 setup,再执行测试函数,最后等待 Fixture 完成 teardown。

Fixture 的创建、注入与清理顺序

作用域决定资源能复用多久

最常见的是 test 作用域和 worker 作用域。没有显式配置时,自定义 Fixture 默认为 test 作用域;它会为每个需要它的测试单独创建并清理。内置 page 也按测试隔离,因此测试之间不会直接共享同一个页面状态。

worker 作用域适合启动成本高、允许同一 worker 内复用的资源,例如测试服务或一组专用账号。定义时使用元组形式并设置 { scope: 'worker' }。它不会在每条测试后销毁,而是在对应 worker 生命周期结束时清理。

依赖关系决定创建与销毁顺序

Fixture 可以依赖另一个 Fixture,例如页面对象依赖 page,登录态页面又依赖账号。若 A 依赖 B,运行器一定先创建 B,再创建 A;销毁时顺序相反,先清理 A,再清理 B。这样依赖者在整个使用期内都能保证被依赖资源仍然有效。

这也是 Fixture 比手写钩子更稳的地方:依赖关系写在参数中,运行器可以据此计算顺序。判断一个依赖是否应该做成 Fixture 时,优先看它是否同时具有“创建成本、明确生命周期、需要注入或自动清理”中的至少一项。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 Fixture 机制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通