自动化测试 / 系统课时
理解 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()。定位器属于页面对象,测试数据属于测试代码;这样同一个页面对象可被成功登录、错误密码、空用户名等多组用例复用。

写出最小可运行页面对象
下面示例适用于 Selenium 4.x Python 绑定,本机需安装 Chrome。它用 data: 页面避免依赖外部站点,LoginPage 只负责定位元素和描述页面动作,主程序负责准备数据并判断结果。
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()预期输出
logged in: alice如果本机首次启动 ChromeDriver,Selenium Manager 可能先解析并准备驱动;这不会改变脚本最终输出。实际项目中把 LoginPage 放到独立模块,测试文件只导入并调用它。
划清封装边界
页面对象适合保存定位器、页面级操作和必要的页面状态读取,例如 open()、search(keyword)、cart_count()。不要把“用户名必须是 alice”“响应必须等于某个业务结果”这类具体测试结论写进 Page Object,否则页面层会被测试场景绑死。
一个实用判断是:如果动作名称在产品需求里也自然成立,例如“登录”“添加购物车”,就适合做页面方法;如果语句表达“应该等于”“必须失败”“期望包含”,通常属于测试断言。页面对象可以返回文本、布尔值或页面组件状态,但由测试代码决定这些值是否正确。
避免把 Page Object 写成万能类
常见错误是把等待、测试数据、数据库清理、API 准备和所有断言都塞进一个 BasePage。这样类会迅速膨胀,页面之间还会产生不必要继承。更稳妥的做法是让每个页面对象只管理当前页面或稳定组件,并优先使用组合而不是深层继承。
当页面元素变化时,先检查是否只需修改对应 Page Object 的定位器;当业务规则变化时,优先修改测试数据和断言。能做到这两类变化落在不同位置,Page Object 的职责就划分得比较清楚。