如何在Playwright TypeScript中为多测试文件实现全局beforeEach/afterEach？

要实现无需每个测试手动引用fixture，就能让多个测试文件自动执行通用的 beforeEach/afterEach 逻辑（比如基于testInfo上传测试结果），最可靠的方式是创建自定义测试套件，将通用逻辑绑定到这个套件上，再让所有测试文件使用这个自定义套件而非默认的test对象。

步骤1：创建自定义测试工具文件 #

新建一个test-utils.ts文件，扩展Playwright的基础测试对象，并在其上添加全局的 beforeEach/afterEach：

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

// 扩展基础测试对象，无需定义额外fixture
export const test = base.extend({});

// 全局beforeEach：每个测试执行前自动运行
test.beforeEach(async ({}, testInfo) => {
  // 这里写前置执行逻辑，比如初始化测试上下文
  console.log(`开始测试：${testInfo.title}（ID：${testInfo.testId}）`);
});

// 全局afterEach：每个测试完成后自动运行，用于上传测试结果
test.afterEach(async ({}, testInfo) => {
  // 基于testInfo组装测试结果
  const testResult = {
    title: testInfo.title,
    status: testInfo.status,
    duration: testInfo.duration,
    error: testInfo.error?.message
  };
  
  // 替换为你的上传API调用逻辑
  // await fetch('你的上传接口地址', {
  //   method: 'POST',
  //   body: JSON.stringify(testResult),
  //   headers: { 'Content-Type': 'application/json' }
  // });
  
  console.log(`测试结束：${testInfo.title}，状态：${testInfo.status}`);
});

步骤2：在测试文件中使用自定义测试套件 #

所有测试文件都导入这个自定义的test对象，替代默认的@playwright/test中的test：

// 导入自定义test，而非默认的
import { test } from './test-utils';
import { expect } from '@playwright/test';

test('示例测试1', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page).toHaveTitle('Example Domain');
});

test('示例测试2', async ({ page }) => {
  await page.goto('https://playwright.dev');
  await expect(page).toHaveTitle(/Playwright/);
});

为什么之前的导入方式不生效？ #

你之前直接导入包含beforeEach的文件时，代码只运行一次，是因为Playwright的模块缓存机制：当多个测试文件导入同一个包含test.beforeEach的文件时，该逻辑只会被注册到默认test实例一次，但如果测试文件的上下文隔离或模块加载顺序问题，会导致注册逻辑未对所有测试生效。而自定义测试套件的方式，让所有测试都绑定到同一个扩展后的test对象，确保每个测试都能触发通用逻辑。

额外保障（可选） #

为了避免新增测试时遗漏导入自定义test，可以配置ESLint规则禁止直接导入默认的test：

// .eslintrc.json
{
  "rules": {
    "no-restricted-imports": [
      "error",
      {
        "paths": [
          {
            "name": "@playwright/test",
            "importNames": ["test"],
            "message": "请从 ./test-utils 导入自定义test对象"
          }
        ]
      }
    ]
  }
}

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