自动化测试 / 系统课时

组织 describe 测试套件

组织 describe 测试套件

本课解决测试数量增加后难以管理的问题。完成学习后,你可以使用 test.describe 按业务模块组织测试,建立清晰的测试层级,并通过运行结果确认测试套件中的用例被正确发现和执行。

学习目标

  • 理解 test.describe 测试套件的作用。
  • 掌握按业务模块划分测试的方法。
  • 能够创建、运行并验证结构化测试文件。

使用 describe 分组测试

当一个页面包含多个测试场景时,可以使用 test.describe 将相关测试归类。它不会改变测试的基本执行方式,但能改善测试文件的组织结构、报告可读性和维护体验。

test.describe 接收套件名称和定义测试的回调函数。在回调中声明的 test() 都属于该套件。例如,用户中心可以包含查看个人信息、退出登录等测试场景。

测试运行器会将套件名称与测试名称组合,形成完整的测试标题。这样即使不同业务模块存在同名测试,也能通过所属套件区分。

Playwright 测试套件层级示意图

创建测试套件

在已安装 @playwright/test 并准备好浏览器运行环境的项目中,新建文件 tests/user-center.spec.ts。下面保留用户中心的两个测试场景,使用 page.setContent() 构造最小页面,使示例无需启动业务服务器即可运行。

ts
import { test, expect } from '@playwright/test';

test.describe('用户中心', () => {
  test('查看个人信息', async ({ page }) => {
    // 使用独立页面内容演示个人信息断言
    await page.setContent('<h1>个人信息</h1><p>用户名:Alice</p>');
    await expect(page.getByRole('heading', { name: '个人信息' })).toBeVisible();
  });

  test('退出登录', async ({ page }) => {
    // 模拟退出按钮触发页面状态变化
    await page.setContent(`<button onclick="document.body.textContent='已退出'">退出登录</button>`);
    await page.getByRole('button', { name: '退出登录' }).click();
    await expect(page.getByText('已退出')).toBeVisible();
  });
});

预期结果:该文件注册两个属于“用户中心”套件的测试。第一个测试检查个人信息标题是否可见,第二个测试点击退出按钮并检查页面状态是否变化。两条断言均应通过。

这里使用模拟页面是为了专注演示测试组织方式。真实项目中应替换为业务页面导航、真实退出操作及相应断言,不能将模拟页面的通过结果当作真实登录系统已经验证成功。

需要注意,test.describe 只负责组织测试,不会自动共享页面或登录状态。Playwright Test 默认为每个测试提供独立的浏览器上下文,因此第二条测试不能依赖第一条测试执行后的页面状态。

运行并检查测试结果

在项目根目录执行以下命令,运行刚创建的测试文件:

bash
npx playwright test tests/user-center.spec.ts --reporter=line

预期输出(项目仅配置一个浏览器测试项目,且两个测试均通过):

text
2 passed (<TIME>)

<TIME> 表示实际运行耗时,不同设备上的数值可能不同。如果配置了多个浏览器项目,每条测试会在对应项目中分别执行,通过数量也会相应增加。

还可以使用 --grep 按完整测试标题筛选套件中的测试:

bash
npx playwright test tests/user-center.spec.ts --grep "用户中心" --list

预期结果:列出属于“用户中心”套件的两个测试及其文件位置,不实际执行测试。启用多个浏览器项目时,列表会包含各项目对应的测试条目。

如果运行时出现 No tests found,先检查文件是否位于配置的 testDir 中、文件名是否匹配 testMatch,以及是否正确使用 test() 声明用例。若浏览器未安装,应先运行 npx playwright install chromium,再重新执行测试。

组织原则与边界

通常可以按照页面、业务模块或用户流程拆分 describe。避免把完全无关的测试放入同一个套件,也不要为了层级完整而创建大量只有一条用例的嵌套套件。

  • 按页面组织:用户资料页、订单详情页等页面各自拥有一个套件。
  • 按业务模块组织:用户中心、购物车、支付模块分别管理相关测试。
  • 按流程组织:注册、登录、退出登录等流程可以组成对应的测试套件。

当一个业务模块存在多个清晰的子场景时,可以嵌套 test.describe,例如在“用户中心”下进一步区分“个人资料”和“账户安全”。但一般保持一到两层分组即可,避免测试报告标题过长。

test.describe 内还可以声明 test.beforeEach 等钩子,为同一套件中的测试提供公共准备步骤。钩子会按其作用范围运行,但不能让不同测试自动共享可变页面状态。

实际维护时,优先选择能直接说明业务含义的套件名称,并保持测试之间相互独立。判断分组是否合理,可以查看测试报告:仅凭“套件名称 + 测试名称”,就应该能够定位失败所属的业务场景。

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

目录与阅读设置

阅读设置

17

记录一个想法

组织 describe 测试套件

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

登录哪都通