自动化测试 / 系统课时

使用生命周期钩子

使用生命周期钩子

生命周期钩子把“每个测试都要做的准备与清理”集中到固定位置。掌握 beforeEach、afterEach 以及套件级钩子的执行顺序后,可以减少重复代码,同时避免把业务断言和环境管理混在一起。

学习目标

  • 使用 beforeEach 和 afterEach 为每个测试准备、清理环境
  • 区分每测试钩子与 beforeAll、afterAll 的适用范围
  • 避免在钩子中制造隐藏依赖和难定位的失败

钩子如何包住测试

Playwright Test 常用四个钩子:beforeAll 在当前测试组开始前执行一次,beforeEach 在每个测试前执行,afterEach 在每个测试后执行,afterAll 在测试组结束后执行。对两个测试而言,顺序可以理解为“组级准备一次,每个测试各自准备与清理,最后组级收尾一次”。

生命周期钩子的执行顺序

beforeEach 最适合创建每个测试都需要、且允许重复创建的状态,例如导航到固定页面、登录测试账号或准备测试数据。afterEach 适合释放测试自己创建的外部资源,例如临时文件、数据库记录或测试服务中的租约。

用 beforeEach 与 afterEach 管理环境

下面的示例在每个测试前创建一个临时标记文件并打开页面,在测试后删除该文件。临时文件用于模拟“测试之外也存在的外部资源”,这样可以看清清理钩子的职责。

ts
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');
});

预期结果

text
1 passed (<TIME>)

<TIME> 会随机器、网络和浏览器启动速度变化。测试结束后,临时目录中的对应标记文件会被删除;Playwright 自己创建的 page 与 context 也会由测试运行器自动回收。

什么时候使用组级钩子

beforeAll 与 afterAll 更适合昂贵且可以安全共享的套件级资源,例如启动一次本地模拟服务。它们不适合创建会被测试修改的用户会话、购物车或页面状态,因为后续测试可能依赖前一个测试留下的结果。

如果某项准备工作既便宜又会被测试修改,优先放在 beforeEach;只有当资源创建成本高、可并发安全共享且不会承载单个测试状态时,才考虑组级钩子。

钩子失败时先看职责边界

钩子越复杂,失败时越难判断是“环境没准备好”还是“业务行为错误”。应让钩子只做稳定、必要的公共工作,把具体业务步骤保留在测试正文中。

清理逻辑还应尽量幂等:资源已经不存在时不应再次失败。这样即使测试断言失败,afterEach 仍能完成收尾,不会用第二个清理错误掩盖真正的失败原因。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用生命周期钩子

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

登录哪都通