Playwright测试框架中Fixture执行顺序的深度解析

Playwright作为现代Web自动化测试框架，其Fixture机制是测试代码结构化的核心设计之一。本文将通过一个典型执行顺序问题案例，剖析Playwright测试生命周期的运作原理。

问题现象还原

在测试实践中，开发者定义了一个包含userFactory的Fixture：

export const test = baseTest.extend<{ userFactory: void }>({
    userFactory: async ({}, use) => {
        console.log('Start');
        await use();
        console.log('End');
    }
});

当配合beforeAll钩子使用时，出现了意外的日志顺序：

Start
End
test

核心原理剖析

1. Fixture生命周期阶段

Playwright的Fixture执行分为三个关键阶段：

• Setup阶段：use()调用前的代码
• 测试执行阶段：use()与use()后的代码之间
• Teardown阶段：use()后的代码

2. 钩子函数的作用域

• beforeAll/afterAll：在worker级别执行（整个测试文件级别）

  • 仅在worker初始化时执行一次
  • 适合全局资源配置（如数据库连接）

• beforeEach/afterEach：在测试用例级别执行

  • 每个测试用例前后都会执行
  • 适合测试隔离（如清理测试数据）

问题根源定位

案例中的异常现象源于对beforeAll的误用。由于beforeAll在worker初始化阶段就执行，导致：

1. 先执行Fixture的Setup阶段（打印"Start"）
2. 立即执行Fixture的Teardown阶段（打印"End"）
3. 最后才执行测试用例内容

正确实践方案

方案一：使用beforeEach替代

test.beforeEach(async ({ userFactory }) => {
    // 每个测试用例前执行
});

此时执行顺序变为：

Start
test
End

方案二：合理使用作用域

对于需要全局初始化的场景，建议：

1. 将一次性初始化逻辑放在beforeAll外的模块作用域
2. 仅将需要清理的逻辑放在afterAll

// 模块初始化
const globalResource = await initResource();

test.afterAll(async () => {
    await cleanupResource();
});

高级应用技巧

1. 复合Fixture模式：将多个相关操作封装成组合Fixture

const userSession = baseTest.extend({
    login: async ({ page }, use) => {
        await page.login();
        await use();
        await page.logout();
    }
});

2. 依赖注入优化：通过Fixture参数自动注入依赖

const test = baseTest.extend<{ apiClient: ApiClient }>({
    apiClient: async ({ baseURL }, use) => {
        const client = new ApiClient(baseURL);
        await use(client);
        await client.disconnect();
    }
});

理解Playwright的Fixture执行机制，能够帮助开发者构建更健壮、可维护的测试套件。关键在于掌握不同作用域钩子的执行时机，以及如何利用Fixture的生命周期管理测试资源。