自动化测试 / 系统课时

理解 Page Object

理解 Page Object

当测试文件里反复出现同一批定位器和点击、填写步骤时,维护成本会迅速上升。Page Object 的目标是把“怎么操作页面”集中封装成稳定接口,让测试只描述业务场景和断言。

学习目标

  • 理解 Page Object 在测试代码与页面细节之间承担的职责
  • 使用 Page 和 Locator 封装可复用的页面操作
  • 判断哪些内容应放进页面对象,哪些应继续留在测试中

Page Object 隔离了什么变化

Page Object 可以看作测试代码与页面实现之间的一层适配器。测试调用 loginAs() 这类业务动作,而页面对象内部保存输入框、按钮等 Locator。当 DOM 结构或定位方式变化时,通常只需要修改页面对象,不必逐个改测试。

Page Object 在测试与页面之间的职责边界

这种封装的价值不是让代码“更面向对象”,而是建立明确的变更边界。一个好的页面对象暴露的是 loginAs()、openProfile() 这样的意图,而不是 clickSecondButton() 这类泄露页面结构的低层动作。

用页面对象封装登录页

下面把登录页的定位器和填写步骤封装到 LoginPage。示例使用 page.setContent() 构造最小页面,不依赖外部网站。将下列内容保存为 tests/login.spec.ts,在已完成 Playwright Test 初始化的项目中即可运行。

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

运行该用例:

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

预期输出的末尾类似如下,耗时会随机器而变化:

text
1 passed (<TIME>)

划清页面对象与测试的职责

页面对象适合保存稳定定位器、导航方法和可复用交互流程,例如登录、提交表单、切换标签页。测试则应保留本次场景的数据组合、关键断言以及“为什么要这样测”的业务语义。

不要把页面对象写成包办一切的巨大类。若一个方法既创建数据、又操作多个页面、又包含大量断言,失败时很难判断是哪一层出了问题。页面对象也不应硬编码测试账号、订单号等场景数据,应通过方法参数传入。

什么时候值得使用 Page Object

只有当定位器或页面动作开始被多个测试复用时,Page Object 才真正产生收益。一次性的小用例如果只有两三个清晰操作,直接写在测试中往往更易读;过早抽象只会增加跳转文件的成本。

当同一页面逐渐包含导航栏、弹窗、表格等可跨页面复用的独立区域时,也不要继续把所有成员塞进一个页面类。此时应进一步拆出组件对象,让页面对象负责组合,组件对象负责各自的局部交互。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Page Object

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

登录哪都通