自动化测试 / 系统课时

读取文本与属性

读取文本与属性

读取元素时最容易混淆的是“页面上看到的文字”“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。

python
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
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 元素。

python
actual = " ".join(message.text.split())
assert actual == "Hello World"

missing = message.get_attribute("title")
assert missing is None

预期结果

text
断言通过,无控制台输出。

如果页面在读取前会异步更新文本或属性,应先等待业务状态稳定,再取值断言;否则拿到的可能只是中间态,而不是接口本身读取错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取文本与属性

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

登录哪都通