自动化测试 / 系统课时
封装页面组件对象
封装页面组件对象
页面对象变大后,导航栏、表格、弹窗等区域常会在多个页面重复出现。把这些区域继续复制进不同 Page Object 会再次制造重复;组件对象通过独立的根定位器和语义方法,把复用边界缩小到具体 UI 组件。
学习目标
- 区分页面对象与组件对象的职责边界
- 使用根
Locator限定组件内部的查找范围 - 让页面对象通过组合复用导航栏、弹窗等组件
组件对象为什么要有自己的边界
页面对象通常代表一个页面或业务页面上下文,组件对象则代表可以独立识别、重复出现的 UI 区域。导航栏、分页表格、确认弹窗都适合单独建模,因为它们拥有自己的定位器、交互规则和状态。

最关键的设计点是从组件根节点开始查找。例如导航栏对象接收一个 navigation 的 Locator,后续所有链接都从这个根节点继续定位,这样即使页面其他位置也出现“设置”链接,也不会误匹配。
用根 Locator 封装导航栏和弹窗
下面的 NavBar 和 ConfirmDialog 都只知道自己的局部区域;SettingsPage 负责创建并组合它们。将下列内容保存为 tests/settings.spec.ts,测试会通过这些对象完成一个跨组件场景。
import { test, expect, type Locator, type Page } from '@playwright/test';
class NavBar {
constructor(private readonly root: Locator) {}
async openSettings() {
// 从导航栏根节点继续查找,避免匹配页面其他同名链接。
await this.root.getByRole('link', { name: '设置' }).click();
}
}
class ConfirmDialog {
readonly message: Locator;
constructor(private readonly root: Locator) {
this.message = root.getByText('确定删除?');
}
async confirm() {
await this.root.getByRole('button', { name: '确认' }).click();
}
}
class SettingsPage {
readonly nav: NavBar;
readonly deleteDialog: ConfirmDialog;
readonly status: Locator;
constructor(private readonly page: Page) {
// 页面对象只负责组合组件和页面级元素。
this.nav = new NavBar(page.getByRole('navigation', { name: '主导航' }));
this.deleteDialog = new ConfirmDialog(
page.getByRole('dialog', { name: '删除确认' })
);
this.status = page.locator('#status');
}
async openDemo() {
await this.page.setContent(`
<nav aria-label="主导航">
<a href="#home">首页</a>
<a href="#settings">设置</a>
</nav>
<main>
<button id="delete">删除账号</button>
<p id="status">active</p>
</main>
<div role="dialog" aria-label="删除确认" hidden>
<p>确定删除?</p>
<button id="confirm">确认</button>
</div>
<script>
const dialog = document.querySelector('[role="dialog"]');
document.querySelector('#delete').addEventListener('click', () => {
dialog.hidden = false;
});
document.querySelector('#confirm').addEventListener('click', () => {
document.querySelector('#status').textContent = 'deleted';
dialog.hidden = true;
});
</script>
`);
}
async requestDelete() {
await this.page.getByRole('button', { name: '删除账号' }).click();
}
}
test('通过复用组件完成删除确认', async ({ page }) => {
const settings = new SettingsPage(page);
await settings.openDemo();
await settings.nav.openSettings();
await expect(page).toHaveURL(/#settings$/);
await settings.requestDelete();
await expect(settings.deleteDialog.message).toBeVisible();
await settings.deleteDialog.confirm();
await expect(settings.status).toHaveText('deleted');
});运行测试:
npx playwright test tests/settings.spec.ts --reporter=line预期输出的末尾类似如下,实际耗时可能不同:
1 passed (<TIME>)组件对象应暴露什么接口
组件对象应优先暴露用户意图,例如 openSettings()、confirm()、selectRow(name),而不是把内部每个按钮都公开给测试。这样组件内部换了标签、层级或定位器时,调用它的测试仍可保持不变。
根 Locator 也是防止组件互相污染的关键。如果页面上有两个表格,就应为两个 Table 对象分别传入不同根节点;组件内部再使用 root.getByRole() 或 root.locator() 查询。只有像全局弹窗这类挂载在页面根部的元素,才由页面对象单独传入相应根定位器。
避免把组件拆得过细
不是每个 div 都需要一个类。一个组件值得独立封装,通常意味着它在多个页面复用、拥有数个相关交互,或内部定位规则较复杂。只有一个按钮且只出现一次的区域,保留在页面对象中更直接。
页面对象与组件对象最好采用组合关系:页面对象负责描述“这个页面有哪些区域以及页面级流程”,组件对象负责“这个区域内部怎么操作”。按这个边界拆分后,复用发生在真正稳定的 UI 单元上,而不是把一个超大 Page Object 从一个测试复制到另一个测试。