自动化测试 / 系统课时

封装页面元素

封装页面元素

封装页面元素的目标不是把定位器“藏起来”,而是让每个元素只有一个明确维护入口。页面结构变化时,只改定位器定义或组件对象,业务测试仍调用同一方法;同时保留足够语义,避免把页面对象写成一堆难懂的 click_button_1()。

学习目标

  • 使用 Selenium 4.x 的定位器元组集中管理页面元素。
  • 通过 find_element(*locator) 复用定位器而不重复选择器字符串。
  • 用稳定属性、等待条件和命名规则降低 DOM 调整带来的修改范围。

用定位器元组集中定义元素

Python Selenium 常把定位器写成 (By.ID, "save") 这样的二元组,再通过参数展开传给 find_element。建议把同一页面的定位器定义成类常量,名称表达业务含义,例如 TITLE_INPUT、SAVE_BUTTON,不要使用 BUTTON_1、INPUT_A 之类位置型名称。

选择定位器时优先稳定且唯一的 id、name 或专门的 data-* 测试属性。若团队能控制前端,可约定 data-testid="save-button";相比依赖 .toolbar > div:nth-child(3) button,页面换布局时更不容易失效。

封装查找与业务动作

下面示例适用于 Selenium 4.x Python 绑定,并使用一个本地 data: 页面。EditorPage 集中保存三个定位器,对外只提供设置标题、保存和读取提示三个动作,测试代码不接触选择器字符串。

python
from urllib.parse import quote

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

class EditorPage:
    TITLE_INPUT = (By.ID, "title")
    SAVE_BUTTON = (By.CSS_SELECTOR, "[data-testid='save-button']")
    MESSAGE = (By.ID, "message")

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

    def set_title(self, value):
        field = self.driver.find_element(*self.TITLE_INPUT)
        field.clear()
        field.send_keys(value)

    def save(self):
        # 业务方法名保持稳定,按钮的 CSS 变化只影响定位器定义。
        self.driver.find_element(*self.SAVE_BUTTON).click()

    def message_text(self):
        return self.driver.find_element(*self.MESSAGE).text

html = '''
<input id="title">
<button data-testid="save-button" onclick="
  document.getElementById('message').textContent =
  'saved: ' + document.getElementById('title').value;
">Save</button>
<div id="message"></div>
'''

driver = webdriver.Chrome()
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))
    page = EditorPage(driver)
    page.set_title("Selenium")
    page.save()
    print(page.message_text())
finally:
    driver.quit()

预期输出

text
saved: Selenium

如果前端把保存按钮从 button 改成 a,但仍保留 data-testid="save-button",这段页面对象无需修改;如果测试属性也改名,只需调整 SAVE_BUTTON 一处。

给动态元素加等待而不是休眠

封装元素时,页面方法要考虑“元素何时可用”。对于异步出现的按钮,不要在测试里到处插入固定 sleep(2);更合适的是让页面对象在点击前等待可点击状态。实际项目可在构造函数中保存 WebDriverWait(driver, 10),其中 10 秒是常见起点,再按系统响应时间调整。

例如保存动作依赖异步按钮时,可将 SAVE_BUTTON 交给 expected_conditions.element_to_be_clickable。等待逻辑应和该页面交互放在一起,这样所有调用者共享同一同步策略;但超时时间不要无限放大,否则真实故障会被拖到很晚才暴露。

检查定位器是否真正降低维护成本

可以用一次“模拟 DOM 改动”验证封装效果:把示例中的 data-testid 改成 data-testid="editor-save",然后只修改 SAVE_BUTTON。如果测试主体仍保持 page.set_title()、page.save() 和 page.message_text() 不变,说明定位器已被正确隔离。

反过来,如果改一个按钮需要同时修改多个测试文件,说明选择器仍泄漏在页面对象之外。若一个页面对象拥有几十个彼此无关区域,则应继续拆成 Header、Dialog、Table 等组件对象,让每个定位器集合对应一个稳定的页面区域。

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

目录与阅读设置

阅读设置

17

记录一个想法

封装页面元素

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

登录哪都通