自动化测试 / 系统课时

封装页面组件对象

封装页面组件对象

页面对象变大后,导航栏、表格、弹窗等区域常会在多个页面重复出现。把这些区域继续复制进不同 Page Object 会再次制造重复;组件对象通过独立的根定位器和语义方法,把复用边界缩小到具体 UI 组件。

学习目标

  • 区分页面对象与组件对象的职责边界
  • 使用根 Locator 限定组件内部的查找范围
  • 让页面对象通过组合复用导航栏、弹窗等组件

组件对象为什么要有自己的边界

页面对象通常代表一个页面或业务页面上下文,组件对象则代表可以独立识别、重复出现的 UI 区域。导航栏、分页表格、确认弹窗都适合单独建模,因为它们拥有自己的定位器、交互规则和状态。

页面对象组合多个组件对象的关系

最关键的设计点是从组件根节点开始查找。例如导航栏对象接收一个 navigation 的 Locator,后续所有链接都从这个根节点继续定位,这样即使页面其他位置也出现“设置”链接,也不会误匹配。

用根 Locator 封装导航栏和弹窗

下面的 NavBar 和 ConfirmDialog 都只知道自己的局部区域;SettingsPage 负责创建并组合它们。将下列内容保存为 tests/settings.spec.ts,测试会通过这些对象完成一个跨组件场景。

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');
});

运行测试:

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

预期输出的末尾类似如下,实际耗时可能不同:

text
1 passed (<TIME>)

组件对象应暴露什么接口

组件对象应优先暴露用户意图,例如 openSettings()、confirm()、selectRow(name),而不是把内部每个按钮都公开给测试。这样组件内部换了标签、层级或定位器时,调用它的测试仍可保持不变。

根 Locator 也是防止组件互相污染的关键。如果页面上有两个表格,就应为两个 Table 对象分别传入不同根节点;组件内部再使用 root.getByRole() 或 root.locator() 查询。只有像全局弹窗这类挂载在页面根部的元素,才由页面对象单独传入相应根定位器。

避免把组件拆得过细

不是每个 div 都需要一个类。一个组件值得独立封装,通常意味着它在多个页面复用、拥有数个相关交互,或内部定位规则较复杂。只有一个按钮且只出现一次的区域,保留在页面对象中更直接。

页面对象与组件对象最好采用组合关系:页面对象负责描述“这个页面有哪些区域以及页面级流程”,组件对象负责“这个区域内部怎么操作”。按这个边界拆分后,复用发生在真正稳定的 UI 单元上,而不是把一个超大 Page Object 从一个测试复制到另一个测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装页面组件对象

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

登录哪都通