Playwright测试框架中全局钩子的正确使用方式

在自动化测试实践中，全局的测试准备和清理工作是非常常见的需求。许多开发者在使用Playwright测试框架时，会遇到一个典型问题：当尝试通过常规的beforeEach和afterEach来实现全局钩子时，发现这些钩子并没有按预期在每个测试用例前执行。

问题现象

开发者通常会创建一个独立的测试钩子文件（如test-hook.ts），在其中定义全局的beforeEach（包含登录操作和日志输出）和afterEach（包含页面关闭和日志输出）。然后将这个文件导入到多个测试文件中。

当运行包含多个测试文件（例如5个文件，每个文件5个测试用例）的测试套件时，会发现：

1. 部分测试用例会意外失败（如每个文件的第一个测试）
2. 单独运行这些失败的测试用例或测试文件时却能通过
3. 通过日志追踪发现失败的测试用例没有执行全局钩子

根本原因

这不是Playwright的bug，而是使用方式的问题。Playwright的设计哲学是通过**测试夹具（Fixtures）**机制来管理测试的初始化和清理工作，而不是直接使用全局的beforeEach/afterEach。

正确解决方案

Playwright提供了专门的夹具API来实现全局的初始化和清理：

1. 创建自定义夹具：

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

export const test = base.extend({
  page: async ({ page }, use) => {
    // 全局初始化代码
    console.log('全局前置操作');
    await page.goto('登录URL');
    
    await use(page);
    
    // 全局清理代码
    console.log('全局后置操作');
    await page.close();
  }
});

2. 在测试文件中使用自定义夹具：

import { test } from './fixtures';

test('测试用例1', async ({ page }) => {
  // 测试代码
});

设计原理

Playwright的夹具系统相比传统的全局钩子有以下优势：

1. 隔离性：每个测试用例获得独立的上下文，避免测试间的相互影响
2. 可组合性：可以灵活组合不同的夹具来满足不同测试场景
3. 明确的生命周期：清晰的初始化和清理阶段划分
4. 更好的错误处理：能更精确地定位初始化或清理过程中的问题

最佳实践建议

1. 对于简单的测试场景，可以直接使用Playwright提供的默认夹具（如page）
2. 对于需要全局初始化的复杂场景，应该创建自定义夹具
3. 避免在测试文件中直接使用beforeEach/afterEach，除非是特定于该文件的局部准备/清理
4. 将常用的夹具组合封装成基础夹具，便于复用

通过正确使用Playwright的夹具系统，开发者可以构建出更健壮、更易维护的自动化测试套件。