自动化测试 / 系统课时

避免过度封装

避免过度封装

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 调用形态。

python
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()

预期输出:

text
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、包装类、服务类和测试,说明抽象层已经超过实际需求。

在代码评审中可直接检查三点:页面对象是否保存定位器并封装页面动作;测试是否仍然掌握业务断言;是否存在只做同名转发的中间方法。满足这三点,通常比继续增加“统一基类”和“公共服务层”更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免过度封装

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

登录哪都通