自动化测试 / 系统课时
避免过度封装
避免过度封装
Page Object 的价值是把定位器和页面操作从测试中移开,但封装层数过多会让一个简单点击需要跨多个类追踪。本篇用可执行的小例子说明怎样保留必要抽象,并识别那些只增加跳转成本、没有隐藏真实变化点的方法。
学习目标
- 判断一个 Page Object 方法是否真正隐藏了页面细节。
- 把业务断言留在测试层,把定位器和页面动作留在页面对象中。
- 用简单规则识别“包装一层但没有新增语义”的无效抽象。
先看职责边界
一个登录页对象通常只需要两类能力:执行页面动作,以及读取页面状态。例如 login(username, password)、error_text() 很合适;login_and_assert_success() 就开始把测试断言带进页面对象。
另一个常见问题是为了“统一接口”继续加一层 LoginService,它内部只调用 LoginPage.login()。如果这一层既不处理跨页面流程,也不做重试、数据转换或权限策略,那么它只是把调用链从两层变成三层。
用最小 Page Object 保留真实语义
下面的示例可直接运行,前提是环境中已安装 Selenium。它用假的 WebDriver 记录调用,因此不需要启动浏览器;Page Object 仍使用真实的 By.ID 定位器和 find_element 调用形态。
from selenium.webdriver.common.by import By
class FakeElement:
def __init__(self, name: str, log: list[str]) -> None:
self.name = name
self.log = log
def send_keys(self, value: str) -> None:
self.log.append(f"{self.name}.send_keys({value})")
def click(self) -> None:
self.log.append(f"{self.name}.click()")
class FakeDriver:
def __init__(self) -> None:
self.log: list[str] = []
def find_element(self, by: str, value: str) -> FakeElement:
self.log.append(f"find_element({by}, {value})")
return FakeElement(value, self.log)
class LoginPage:
USERNAME = (By.ID, "username")
PASSWORD = (By.ID, "password")
SUBMIT = (By.ID, "submit")
def __init__(self, driver: FakeDriver) -> None:
self.driver = driver
def login(self, username: str, password: str) -> None:
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 main() -> None:
driver = FakeDriver()
LoginPage(driver).login("alice", "secret")
print("\n".join(driver.log))
if __name__ == "__main__":
main()预期输出:
find_element(id, username)
username.send_keys(alice)
find_element(id, password)
password.send_keys(secret)
find_element(id, submit)
submit.click()这个类已经把三个定位器和登录动作藏在页面对象里,再额外增加 LoginActions.login() 去原样转发调用,并不会减少测试对页面变化的感知。
识别三种无效抽象
第一种是“一行转发”:方法内部只有 return self.page.submit(),方法名也没有增加业务语义。第二种是“万能方法”:例如 login_as(role, expect_success=True, clear_cookies=False),一个入口塞进多条分支,使失败时难以判断走了哪条路径。第三种是“断言下沉”:页面对象内部直接断言 URL、权限或业务结果,让同一页面无法被成功、失败、锁定等不同场景复用。
可以用一个简单检查法:如果删除某个中间类后,测试代码只少一个对象名,定位器、等待和业务规则都没有重新暴露出来,那么这层抽象大概率没有价值。
把等待放在靠近页面变化的位置
等待属于页面交互细节,适合由 Page Object 封装;但“登录后必须看到管理员菜单”属于测试断言,不应和等待一起塞进 login()。例如页面对象可以提供 wait_until_ready() 或在 login() 内等待提交按钮可点击,测试再单独断言目标业务状态。
用变更成本验证抽象是否合适
修改一个定位器时,理想情况只改一个 Page Object;修改“登录成功的判断标准”时,理想情况只改相关测试或专门的业务流程层。若一次小改动需要同时调整 Page Object、包装类、服务类和测试,说明抽象层已经超过实际需求。
在代码评审中可直接检查三点:页面对象是否保存定位器并封装页面动作;测试是否仍然掌握业务断言;是否存在只做同名转发的中间方法。满足这三点,通常比继续增加“统一基类”和“公共服务层”更容易维护。