自动化测试 / 系统课时
封装页面元素
封装页面元素
封装页面元素的目标不是把定位器“藏起来”,而是让每个元素只有一个明确维护入口。页面结构变化时,只改定位器定义或组件对象,业务测试仍调用同一方法;同时保留足够语义,避免把页面对象写成一堆难懂的 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 集中保存三个定位器,对外只提供设置标题、保存和读取提示三个动作,测试代码不接触选择器字符串。
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()预期输出
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 等组件对象,让每个定位器集合对应一个稳定的页面区域。