自动化测试 / 系统课时
组织 describe 测试套件
组织 describe 测试套件
本课解决测试数量增加后难以管理的问题。完成学习后,你可以使用 test.describe 按业务模块组织测试,建立清晰的测试层级,并通过运行结果确认测试套件中的用例被正确发现和执行。
学习目标
- 理解
test.describe测试套件的作用。 - 掌握按业务模块划分测试的方法。
- 能够创建、运行并验证结构化测试文件。
使用 describe 分组测试
当一个页面包含多个测试场景时,可以使用 test.describe 将相关测试归类。它不会改变测试的基本执行方式,但能改善测试文件的组织结构、报告可读性和维护体验。
test.describe 接收套件名称和定义测试的回调函数。在回调中声明的 test() 都属于该套件。例如,用户中心可以包含查看个人信息、退出登录等测试场景。
测试运行器会将套件名称与测试名称组合,形成完整的测试标题。这样即使不同业务模块存在同名测试,也能通过所属套件区分。

创建测试套件
在已安装 @playwright/test 并准备好浏览器运行环境的项目中,新建文件 tests/user-center.spec.ts。下面保留用户中心的两个测试场景,使用 page.setContent() 构造最小页面,使示例无需启动业务服务器即可运行。
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 默认为每个测试提供独立的浏览器上下文,因此第二条测试不能依赖第一条测试执行后的页面状态。
运行并检查测试结果
在项目根目录执行以下命令,运行刚创建的测试文件:
npx playwright test tests/user-center.spec.ts --reporter=line预期输出(项目仅配置一个浏览器测试项目,且两个测试均通过):
2 passed (<TIME>)<TIME> 表示实际运行耗时,不同设备上的数值可能不同。如果配置了多个浏览器项目,每条测试会在对应项目中分别执行,通过数量也会相应增加。
还可以使用 --grep 按完整测试标题筛选套件中的测试:
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 等钩子,为同一套件中的测试提供公共准备步骤。钩子会按其作用范围运行,但不能让不同测试自动共享可变页面状态。
实际维护时,优先选择能直接说明业务含义的套件名称,并保持测试之间相互独立。判断分组是否合理,可以查看测试报告:仅凭“套件名称 + 测试名称”,就应该能够定位失败所属的业务场景。