自动化测试 / 系统课时
避免过度封装
避免过度封装
复用代码能减少重复,但抽象过多会把测试意图藏进层层 helper、基类和通用包装器。本篇用 Playwright 示例说明哪些逻辑值得提取、哪些步骤应留在用例里,并给出判断抽象是否有价值的实用标准。
学习目标
- 识别只改名、不增加语义的无效抽象
- 用小而稳定的 helper 表达重复业务动作
- 保留关键断言和测试意图,使失败位置容易定位
先看抽象是否真的减少认知成本
测试里的抽象应该隐藏无关细节,而不是隐藏业务事实。clickElement(selector)、fillField(selector, value) 这类包装通常只是把 Playwright API 换了名字,读者仍然要追进去才能知道点了什么、填了什么。
更值得提取的是稳定且重复出现的业务动作,例如“登录”“创建订单”“清空购物车”。它们有明确语义,也能把容易变化的选择器集中到一个位置。相反,只出现一次的两三行操作通常直接写在测试里更清楚。
让 helper 表达业务动作
下面的示例完全使用 page.setContent() 构造页面,因此不依赖外部站点。signIn 只封装一个稳定业务动作,最终断言仍留在测试中,读者不用跳转到 helper 才能知道本例要验证什么。
import { test, expect, type Page } from '@playwright/test';
async function signIn(page: Page, username: string) {
await page.getByLabel('用户名').fill(username);
await page.getByRole('button', { name: '登录' }).click();
}
test('用户登录后看到欢迎信息', async ({ page }) => {
await page.setContent(`
<label>用户名 <input /></label>
<button>登录</button>
<p id="status">未登录</p>
<script>
document.querySelector('button').addEventListener('click', () => {
const user = document.querySelector('input').value;
document.querySelector('#status').textContent = '欢迎,' + user;
});
</script>
`);
// helper 负责重复动作,断言保留在用例中表达真正的测试意图。
await signIn(page, 'alice');
await expect(page.locator('#status')).toHaveText('欢迎,alice');
});预期输出:使用项目现有的 Playwright 测试命令运行该文件时,用例应通过。
1 passed (<TIME>)<TIME> 是动态值。这个例子里,signIn 有业务名称且隐藏了两个稳定操作;如果再把 getByLabel()、fill()、click() 分别包装一层,代码反而会更难读。
保留断言附近的上下文
过度封装最常见的副作用,是失败信息离业务目标越来越远。例如 helper 内部同时完成导航、点击、重试和断言,最终测试只剩一句 completeFlow()。当它失败时,读者很难从测试文件判断到底在验证什么。
除非断言本身就是组件或页面对象的稳定契约,否则优先把关键 expect() 留在测试中。这样测试名称、操作和结果能在同一屏内形成因果关系,失败时也更容易知道应检查页面状态还是复用逻辑。
用三个问题决定要不要提取
准备创建新的 helper、Page Object 方法或基类之前,可以先检查三件事:
- 这段逻辑是否在多个用例中以相同业务含义重复出现。
- 提取后是否减少了调用方必须理解的技术细节,而不是单纯缩短行数。
- 失败时能否从方法名和测试上下文快速判断发生了什么。
如果答案大多是否定的,就先保留显式 Playwright API。重复两三行并不一定是坏事;对自动化测试来说,可读的意图和可定位的失败通常比“零重复”更重要。
Page Object 也要保持薄而明确
Page Object 本身不是过度封装。问题通常出在把所有点击、等待、数据生成、网络请求和断言都塞进一个巨型类,或者建立多层继承只为复用几个选择器。
更稳妥的做法是让 Page Object 管理页面级定位器和稳定交互,让 fixture 负责测试依赖与生命周期,让测试保留场景编排和关键断言。这样每一层只有一个清晰职责,复用不会牺牲测试意图。
判断抽象是否成功的标准很简单:调用处应该比直接写 Playwright API 更容易理解业务目的,同时失败时不需要连续跳转多个文件才能定位原因。达不到这两点的封装,即使减少了代码行数,也值得拆掉。