自动化测试 / 系统课时
使用生命周期钩子
使用生命周期钩子
生命周期钩子把“每个测试都要做的准备与清理”集中到固定位置。掌握 beforeEach、afterEach 以及套件级钩子的执行顺序后,可以减少重复代码,同时避免把业务断言和环境管理混在一起。
学习目标
- 使用
beforeEach和afterEach为每个测试准备、清理环境 - 区分每测试钩子与
beforeAll、afterAll的适用范围 - 避免在钩子中制造隐藏依赖和难定位的失败
钩子如何包住测试
Playwright Test 常用四个钩子:beforeAll 在当前测试组开始前执行一次,beforeEach 在每个测试前执行,afterEach 在每个测试后执行,afterAll 在测试组结束后执行。对两个测试而言,顺序可以理解为“组级准备一次,每个测试各自准备与清理,最后组级收尾一次”。

beforeEach 最适合创建每个测试都需要、且允许重复创建的状态,例如导航到固定页面、登录测试账号或准备测试数据。afterEach 适合释放测试自己创建的外部资源,例如临时文件、数据库记录或测试服务中的租约。
用 beforeEach 与 afterEach 管理环境
下面的示例在每个测试前创建一个临时标记文件并打开页面,在测试后删除该文件。临时文件用于模拟“测试之外也存在的外部资源”,这样可以看清清理钩子的职责。
import { test, expect } from '@playwright/test';
import { promises as fs } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
let markerPath = '';
test.beforeEach(async ({ page }, testInfo) => {
markerPath = path.join(
os.tmpdir(),
`pw-${testInfo.workerIndex}-${testInfo.parallelIndex}.txt`,
);
// 每个测试独立准备自己的外部资源和页面初始状态。
await fs.writeFile(markerPath, testInfo.title, 'utf8');
await page.goto('https://example.com');
});
test.afterEach(async () => {
// 清理由本测试创建的外部资源;不存在时也不把清理变成新故障。
await fs.rm(markerPath, { force: true });
});
test('page is ready', async ({ page }) => {
await expect(page).toHaveTitle(/Example Domain/);
await expect(page.locator('h1')).toHaveText('Example Domain');
});预期结果
1 passed (<TIME>)<TIME> 会随机器、网络和浏览器启动速度变化。测试结束后,临时目录中的对应标记文件会被删除;Playwright 自己创建的 page 与 context 也会由测试运行器自动回收。
什么时候使用组级钩子
beforeAll 与 afterAll 更适合昂贵且可以安全共享的套件级资源,例如启动一次本地模拟服务。它们不适合创建会被测试修改的用户会话、购物车或页面状态,因为后续测试可能依赖前一个测试留下的结果。
如果某项准备工作既便宜又会被测试修改,优先放在 beforeEach;只有当资源创建成本高、可并发安全共享且不会承载单个测试状态时,才考虑组级钩子。
钩子失败时先看职责边界
钩子越复杂,失败时越难判断是“环境没准备好”还是“业务行为错误”。应让钩子只做稳定、必要的公共工作,把具体业务步骤保留在测试正文中。
清理逻辑还应尽量幂等:资源已经不存在时不应再次失败。这样即使测试断言失败,afterEach 仍能完成收尾,不会用第二个清理错误掩盖真正的失败原因。