自动化测试 / 系统课时
理解 Page Object
理解 Page Object
当测试文件里反复出现同一批定位器和点击、填写步骤时,维护成本会迅速上升。Page Object 的目标是把“怎么操作页面”集中封装成稳定接口,让测试只描述业务场景和断言。
学习目标
- 理解 Page Object 在测试代码与页面细节之间承担的职责
- 使用
Page和Locator封装可复用的页面操作 - 判断哪些内容应放进页面对象,哪些应继续留在测试中
Page Object 隔离了什么变化
Page Object 可以看作测试代码与页面实现之间的一层适配器。测试调用 loginAs() 这类业务动作,而页面对象内部保存输入框、按钮等 Locator。当 DOM 结构或定位方式变化时,通常只需要修改页面对象,不必逐个改测试。

这种封装的价值不是让代码“更面向对象”,而是建立明确的变更边界。一个好的页面对象暴露的是 loginAs()、openProfile() 这样的意图,而不是 clickSecondButton() 这类泄露页面结构的低层动作。
用页面对象封装登录页
下面把登录页的定位器和填写步骤封装到 LoginPage。示例使用 page.setContent() 构造最小页面,不依赖外部网站。将下列内容保存为 tests/login.spec.ts,在已完成 Playwright Test 初始化的项目中即可运行。
import { test, expect, type Locator, type Page } from '@playwright/test';
class LoginPage {
readonly userName: Locator;
readonly password: Locator;
readonly submitButton: Locator;
readonly welcome: Locator;
constructor(private readonly page: Page) {
// 定位器集中在页面对象中,测试不需要知道 DOM 细节。
this.userName = page.getByLabel('用户名');
this.password = page.getByLabel('密码');
this.submitButton = page.getByRole('button', { name: '登录' });
this.welcome = page.getByTestId('welcome');
}
async open() {
await this.page.setContent(`
<label>用户名 <input aria-label="用户名"></label>
<label>密码 <input aria-label="密码" type="password"></label>
<button id="login">登录</button>
<p data-testid="welcome"></p>
<script>
document.querySelector('#login').addEventListener('click', () => {
const name = document.querySelector('[aria-label="用户名"]').value;
document.querySelector('[data-testid="welcome"]').textContent =
'欢迎,' + name;
});
</script>
`);
}
async loginAs(username: string, password: string) {
// 对外暴露一个业务动作,隐藏填写与点击的具体顺序。
await this.userName.fill(username);
await this.password.fill(password);
await this.submitButton.click();
}
}
test('用户可以登录', async ({ page }) => {
const loginPage = new LoginPage(page);
await loginPage.open();
await loginPage.loginAs('alice', 'secret');
// 场景是否成功仍由测试断言,失败时意图更清楚。
await expect(loginPage.welcome).toHaveText('欢迎,alice');
});运行该用例:
npx playwright test tests/login.spec.ts --reporter=line预期输出的末尾类似如下,耗时会随机器而变化:
1 passed (<TIME>)划清页面对象与测试的职责
页面对象适合保存稳定定位器、导航方法和可复用交互流程,例如登录、提交表单、切换标签页。测试则应保留本次场景的数据组合、关键断言以及“为什么要这样测”的业务语义。
不要把页面对象写成包办一切的巨大类。若一个方法既创建数据、又操作多个页面、又包含大量断言,失败时很难判断是哪一层出了问题。页面对象也不应硬编码测试账号、订单号等场景数据,应通过方法参数传入。
什么时候值得使用 Page Object
只有当定位器或页面动作开始被多个测试复用时,Page Object 才真正产生收益。一次性的小用例如果只有两三个清晰操作,直接写在测试中往往更易读;过早抽象只会增加跳转文件的成本。
当同一页面逐渐包含导航栏、弹窗、表格等可跨页面复用的独立区域时,也不要继续把所有成员塞进一个页面类。此时应进一步拆出组件对象,让页面对象负责组合,组件对象负责各自的局部交互。