自动化测试 / 系统课时
读取文本与属性
读取文本与属性
读取元素时最容易混淆的是“页面上看到的文字”“HTML 属性”和“运行时 DOM 属性”。本课用一个可运行页面把三者同时拉开,最后能按测试目的选择 text、get_dom_attribute()、get_property() 或 get_attribute()。
学习目标
- 读取元素的可见文本,并理解它与源码文本的差异
- 区分 HTML attribute、DOM property 与
get_attribute()的回退规则 - 用一段可运行脚本验证属性在运行时变化后的读取结果
先区分四种读取方式
Selenium Python 4.x 中,element.text 返回元素的渲染文本;get_dom_attribute(name) 读取 DOM attribute;get_property(name) 读取对应 DOM property;get_attribute(name) 会先尝试同名 property,不存在时再回退到 attribute。需要精确区分两者时,不要把 get_attribute() 当成唯一入口。
| 读取方式 | 适合检查 | 例子 |
|---|---|---|
element.text |
用户实际能看到的文本 | 按钮标题、提示语 |
get_dom_attribute("data-role") |
HTML/DOM attribute | data-*、href、class |
get_property("value") |
运行时 property | 输入框当前 value |
get_attribute("value") |
兼容式读取 | 先 property,后 attribute |
比如输入框初始写着 value="markup-value",随后 JavaScript 只修改 input.value。此时 attribute 仍可保持 markup-value,property 已经变成 runtime-value,这正是表单自动化里常见的差异。
用一个页面同时验证差异
下面示例适用于 Selenium 4.x Python 绑定。它通过 data: 页面创建固定 DOM,不依赖外部站点;需要本机已安装可用浏览器,webdriver.Chrome() 会按当前 Selenium 配置启动 Chrome。
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
html = """
<!doctype html>
<html>
<body>
<div id="message" data-role="status">Hello <span>World</span></div>
<input id="name" value="markup-value">
</body>
</html>
"""
# 使用 data URL 固定测试输入,避免依赖外部页面内容。
driver = webdriver.Chrome()
try:
driver.get("data:text/html;charset=utf-8," + quote(html))
message = driver.find_element(By.ID, "message")
name = driver.find_element(By.ID, "name")
# 只修改 DOM property,不调用 setAttribute。
driver.execute_script(
"arguments[0].value = 'runtime-value';",
name,
)
print(f"text={message.text!r}")
print(f"data-role={message.get_dom_attribute('data-role')!r}")
print(f"dom value={name.get_dom_attribute('value')!r}")
print(f"property value={name.get_property('value')!r}")
print(f"attribute value={name.get_attribute('value')!r}")
finally:
driver.quit()预期输出
text='Hello World'
data-role='status'
dom value='markup-value'
property value='runtime-value'
attribute value='runtime-value'这个结果说明 get_attribute("value") 不等于“读取标签源码中的 value”。它优先返回同名 property;要核对原生 attribute 与运行时 property,应分别调用专用方法。
按测试目的选择接口
检查用户界面文案时优先使用 element.text,因为它面向渲染后的可见文本;不要用 get_dom_attribute("textContent") 代替,因为 textContent 本身是 DOM property,不是“用户看见的文本”。读取 data-test-id、aria-* 或固定业务标记时,用 get_dom_attribute() 更明确。
检查输入框当前值、复选框 checked 等会被脚本或用户操作改变的状态时,用 get_property()。如果测试只需要一个方便值且能够接受 property 优先的规则,可以使用 get_attribute(),但断言失败时要知道它究竟读到了哪一层。
处理空值与文本断言
属性可能不存在,因此业务断言不要把“缺失”和“空字符串”混为一谈。对于可见文本,浏览器渲染还可能合并空白;当页面文案允许多余空格时,可以先做有限规范化,再比较业务内容。
片段示例:下面代码依赖前一示例已经取得的 message 元素。
actual = " ".join(message.text.split())
assert actual == "Hello World"
missing = message.get_attribute("title")
assert missing is None预期结果
断言通过,无控制台输出。如果页面在读取前会异步更新文本或属性,应先等待业务状态稳定,再取值断言;否则拿到的可能只是中间态,而不是接口本身读取错误。