自动化测试 / 系统课时

理解 DOM 与 WebElement

理解 DOM 与 WebElement

页面自动化先要把“页面里的节点”和“代码里的元素对象”对应起来。本课用一个可运行的本地页面说明 DOM、HTML 属性与 Selenium WebElement 的关系,并验证读取标签名、文本、属性和可用状态时实际发生了什么。

学习目标

  • 能从 DOM 结构中识别 Selenium 要操作的具体节点。
  • 能理解 find_element 返回的 WebElement 与页面节点之间的引用关系。
  • 能用 WebElement 读取文本、属性和状态,并识别元素失效的典型场景。

从 DOM 找到可操作节点

浏览器解析 HTML 后会形成 DOM 树。以按钮 <button id="save-btn" data-role="primary-action">保存</button> 为例,button 是标签名,id 与 data-role 是属性,“保存”是节点的可见文本。自动化定位的目标不是一段 HTML 字符串,而是当前文档中的具体 DOM 节点。

片段示例:页面源码。

html
<main id="app">
  <h1>编辑资料</h1>
  <button id="save-btn" data-role="primary-action">保存</button>
</main>

这段结构中,#app 是父节点,#save-btn 是其后代节点。浏览器开发者工具的 Elements 面板看到的是 DOM 结构;Selenium 则通过定位器找到其中一个节点,并在测试代码侧返回对应的 WebElement。

WebElement 是对当前页面元素的引用

driver.find_element(...) 成功后返回 WebElement。它不是把节点完整复制到 Python 内存,而是让后续命令继续指向浏览器会话中的那个元素,因此可以读取 text、tag_name、属性,也可以执行 click()、send_keys() 等操作。

DOM 节点、定位器与 WebElement 的对应关系

如果页面刷新、跳转,或前端框架删除旧节点再创建新节点,原来的引用可能失效。此时继续操作旧对象会出现 stale element reference;正确做法是等待新页面状态成立后重新定位,而不是长期缓存旧 WebElement。

用本地页面验证元素对象

下面示例适用于 Selenium 4.x、Python 3.10+,前提是已安装 selenium 且本机存在 Chrome。代码创建临时 HTML 文件,定位按钮后读取四项稳定属性;临时目录退出后自动清理,不依赖外部网站。

python
from pathlib import Path
from tempfile import TemporaryDirectory

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

html = '''<!doctype html>
<html lang="zh-CN">
<body>
  <button id="save-btn" data-role="primary-action">保存</button>
</body>
</html>'''

with TemporaryDirectory() as tmp:
    page = Path(tmp) / "page.html"
    page.write_text(html, encoding="utf-8")

    driver = webdriver.Chrome()
    try:
        driver.get(page.as_uri())
        button = driver.find_element(By.ID, "save-btn")

        print(button.tag_name)
        print(button.text)
        print(button.get_attribute("data-role"))
        print(button.is_enabled())
    finally:
        driver.quit()

预期输出

text
button
保存
primary-action
True

tag_name 验证定位结果确实是按钮,text 读取可见文本,get_attribute("data-role") 读取业务属性,is_enabled() 用于判断控件是否可交互。若这四项与预期不一致,应先检查定位目标是否找错,再排查页面状态。

区分源码、当前 DOM 与元素状态

测试时不要把“查看页面源码”等同于“当前 DOM”。JavaScript 可以在加载后修改文本、属性或整段节点,Selenium 操作的是当前浏览器中的页面状态。排查问题时可同时检查 Elements 面板与 WebElement 读取值:例如按钮文本应为“保存”、data-role 应为 primary-action,两边不一致通常意味着页面仍在更新或定位到了别的元素。

对于会频繁重渲染的区域,实用规则是“定位尽量靠近操作时刻”。例如等待按钮出现后立即重新定位并点击,比页面刚打开时先保存一个元素对象、数秒后再操作更可靠。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 DOM 与 WebElement

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

登录哪都通