自动化测试 / 系统课时

理解 Page Object

理解 Page Object

Page Object 把“页面长什么样”和“测试要做什么”分开:定位器、点击与输入细节留在页面对象里,测试只调用登录、保存、读取结果等业务动作。最终效果是页面 DOM 小改时优先修改一个类,而不是逐个搜索所有测试用例。

学习目标

  • 理解测试代码、Page Object、WebDriver 与页面 DOM 的职责边界。
  • 能用 Selenium 4.x Python 编写一个可运行的页面对象。
  • 判断哪些逻辑应该封装进页面对象,哪些断言应留在测试层。

Page Object 解决什么问题

直接在测试里反复写 find_element,短期很快,但页面一旦把 id="username" 改成 name="account",十几个用例可能同时失败。Page Object 的做法是让测试依赖“输入用户名”“提交登录”这类页面能力,而不是依赖具体 CSS 或 DOM 细节。

例如一个登录页可以只暴露 login(username, password) 和 status_text()。定位器属于页面对象,测试数据属于测试代码;这样同一个页面对象可被成功登录、错误密码、空用户名等多组用例复用。

测试代码经 Page Object 调用 WebDriver 并操作页面 DOM 的分层关系

写出最小可运行页面对象

下面示例适用于 Selenium 4.x Python 绑定,本机需安装 Chrome。它用 data: 页面避免依赖外部站点,LoginPage 只负责定位元素和描述页面动作,主程序负责准备数据并判断结果。

python
from urllib.parse import quote

from selenium import webdriver
from selenium.webdriver.common.by import By

class LoginPage:
    USERNAME = (By.ID, "username")
    PASSWORD = (By.ID, "password")
    SUBMIT = (By.ID, "submit")
    STATUS = (By.ID, "status")

    def __init__(self, driver):
        self.driver = driver

    def login(self, username, password):
        # 页面对象封装交互细节,调用方不需要知道元素如何定位。
        self.driver.find_element(*self.USERNAME).send_keys(username)
        self.driver.find_element(*self.PASSWORD).send_keys(password)
        self.driver.find_element(*self.SUBMIT).click()

    def status_text(self):
        return self.driver.find_element(*self.STATUS).text

html = '''
<input id="username">
<input id="password" type="password">
<button id="submit" onclick="
  document.getElementById('status').textContent =
  'logged in: ' + document.getElementById('username').value;
">Login</button>
<div id="status"></div>
'''

driver = webdriver.Chrome()
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))
    page = LoginPage(driver)
    page.login("alice", "secret")
    print(page.status_text())
finally:
    driver.quit()

预期输出

text
logged in: alice

如果本机首次启动 ChromeDriver,Selenium Manager 可能先解析并准备驱动;这不会改变脚本最终输出。实际项目中把 LoginPage 放到独立模块,测试文件只导入并调用它。

划清封装边界

页面对象适合保存定位器、页面级操作和必要的页面状态读取,例如 open()、search(keyword)、cart_count()。不要把“用户名必须是 alice”“响应必须等于某个业务结果”这类具体测试结论写进 Page Object,否则页面层会被测试场景绑死。

一个实用判断是:如果动作名称在产品需求里也自然成立,例如“登录”“添加购物车”,就适合做页面方法;如果语句表达“应该等于”“必须失败”“期望包含”,通常属于测试断言。页面对象可以返回文本、布尔值或页面组件状态,但由测试代码决定这些值是否正确。

避免把 Page Object 写成万能类

常见错误是把等待、测试数据、数据库清理、API 准备和所有断言都塞进一个 BasePage。这样类会迅速膨胀,页面之间还会产生不必要继承。更稳妥的做法是让每个页面对象只管理当前页面或稳定组件,并优先使用组合而不是深层继承。

当页面元素变化时,先检查是否只需修改对应 Page Object 的定位器;当业务规则变化时,优先修改测试数据和断言。能做到这两类变化落在不同位置,Page Object 的职责就划分得比较清楚。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Page Object

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

登录哪都通