自动化测试 / 系统课时

封装页面业务操作

封装页面业务操作

当测试直接堆叠 find_element、send_keys 和 click 时,业务意图会被元素细节淹没。把“登录、查询、提交”封装成页面对象的方法后,测试只描述用户要完成的动作,定位器、等待条件和交互顺序统一留在 Page Object 内部。

学习目标

  • 能把多步页面交互封装成一个有业务含义的方法。
  • 能区分“页面动作方法”和“测试断言”,避免 Page Object 代替测试做结论。
  • 能用显式等待保证业务方法返回时页面已经到达可验证状态。

方法边界要按业务动作划分

一个方法应对应用户能说清楚的动作,例如 login(username, password)、search_order(order_id)、submit_profile()。不要把 click_login_button()、fill_username() 继续暴露给测试,否则测试仍然需要知道页面内部步骤。

封装层级 不推荐 推荐
登录 fill_username() + fill_password() + click_submit() login(username, password)
查询 type_keyword() + click_search() search(keyword)
提交 click_save() 后由测试自己等提示 submit() 内等待稳定状态

业务方法可以返回 self 以便继续调用,也可以返回页面结果对象;但“登录是否符合预期角色”这类业务结论应由测试断言完成。

测试代码到页面业务方法再到 WebDriver 的分层关系

用一个完整页面对象封装登录

下面示例不依赖外部网站:Chrome 打开空白 data: 页面后,用浏览器脚本创建最小 DOM,再由 LoginPage.login() 完成输入、点击和等待。测试代码只关心业务动作和最终状态。

python
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait

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
        self.wait = WebDriverWait(driver, 5)

    def open_demo(self):
        self.driver.get("data:text/html,")
        self.driver.execute_script(
            '''
const body = document.body;
const username = document.createElement("input");
username.id = "username";
const password = document.createElement("input");
password.id = "password";
const submit = document.createElement("button");
submit.id = "submit";
submit.textContent = "Login";
const status = document.createElement("div");
status.id = "status";
submit.addEventListener("click", () => {
  status.textContent =
    username.value === "alice" && password.value === "secret"
      ? "Welcome alice"
      : "Invalid";
});
body.append(username, password, submit, status);
'''
        )
        return self

    def login(self, username, password):
        user_input = self.wait.until(
            lambda d: d.find_element(*self.USERNAME)
        )
        password_input = self.driver.find_element(*self.PASSWORD)
        user_input.clear()
        user_input.send_keys(username)
        password_input.clear()
        password_input.send_keys(password)
        self.driver.find_element(*self.SUBMIT).click()
        self.wait.until(
            lambda d: d.find_element(*self.STATUS).text != ""
        )
        return self

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

def main():
    driver = webdriver.Chrome()
    try:
        page = LoginPage(driver).open_demo()
        page.login("alice", "secret")
        print(f"status={page.status_text()}")
    finally:
        driver.quit()

if __name__ == "__main__":
    main()

预期输出:

text
status=Welcome alice

使用 Selenium 4.6+ 且本机已安装 Chrome 时,webdriver.Chrome() 可由 Selenium Manager 处理驱动发现与匹配。实际首次启动可能额外发生驱动下载,但程序打印的业务结果应保持一致。

让方法返回在稳定状态

业务方法不应在“按钮刚点击”时结束。上例在 click() 后等待 #status 出现非空文本,这样调用方拿回控制权时,页面已经进入可验证状态。真实项目里可等待 URL、成功提示、用户菜单或列表刷新。

等待也不要写得过宽。登录方法只负责等待“登录动作完成的信号”,角色权限、账号名称等仍交给测试断言,这样同一个方法可以服务成功、失败和不同账号场景。

检查封装是否过度

检查一个 Page Object 方法时,可以用三个问题快速判断:测试调用处是否还能看见定位器;页面改一个选择器时是否只需改一处;失败时方法名能否说明正在执行哪项业务动作。若答案分别是“不能、是、能”,封装边界通常合理。

反过来,如果一个 do_everything() 同时登录、搜索、下单、退出,它会跨越多个页面状态,失败位置难以定位。更合适的做法是保留 login()、search()、submit_order() 等独立业务动作,让测试负责组合场景。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装页面业务操作

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

登录哪都通