自动化测试 / 系统课时

等待元素可见

等待元素可见

“元素存在”不等于“用户能看见”。前端经常先把节点放进 DOM,再通过 CSS、动画或异步数据把它显示出来。本节用 visibility_of_element_located 等到元素真正进入可见状态,并区分存在、可见与可点击三类条件。

学习目标

  • 使用 visibility_of_element_located 等待元素出现并可见。
  • 区分 presence、visibility 与 clickable 的适用场景。
  • 在动态重渲染页面中选择更稳妥的定位式等待。

可见条件比存在条件多检查一步

presence_of_element_located 只要求定位器能在 DOM 中找到节点;visibility_of_element_located 还要求 Selenium 判断该元素为显示状态,并具有大于 0 的尺寸。对于 display: none 的元素,前者可以立即成功,后者会继续等待。

后续动作 推荐条件 原因
只读取节点是否已创建 presence_of_element_located 不要求页面可见
读取可见文本或截图 visibility_of_element_located 需要用户可见状态
准备点击按钮 element_to_be_clickable 在可见基础上还检查 enabled
等加载遮罩消失 invisibility_of_element_located 不可见或已从 DOM 移除都可结束

如果下一步是点击,单纯“可见”仍不是完整保证。element_to_be_clickable 检查可见和 enabled,但页面上若还有覆盖层挡住目标,实际点击仍可能抛出 ElementClickInterceptedException,此时应继续等待遮罩消失。

等待隐藏元素被显示

下面页面一开始就包含按钮,但按钮使用 display:none 隐藏,1.2 秒后才显示。代码先验证“存在条件”会立即通过,再等待“可见条件”成立。这样可以直接观察两种等待的差异。

python
from urllib.parse import quote

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait

html = """
<!doctype html>
<meta charset="utf-8">
<button id="submit" style="display:none">提交</button>
<script>
setTimeout(() => {
  document.getElementById("submit").style.display = "block";
}, 1200);
</script>
"""

driver = webdriver.Chrome()

try:
    driver.get("data:text/html;charset=utf-8," + quote(html))

    present = WebDriverWait(driver, 1).until(
        EC.presence_of_element_located((By.ID, "submit"))
    )
    print(
        f"present={present is not None}, "
        f"displayed_before={present.is_displayed()}"
    )

    visible = WebDriverWait(driver, 5).until(
        EC.visibility_of_element_located((By.ID, "submit"))
    )
    print(
        f"displayed_after={visible.is_displayed()}, "
        f"text={visible.text}"
    )
finally:
    driver.quit()

预期输出

text
present=True, displayed_before=False
displayed_after=True, text=提交

第一行说明节点从一开始就在 DOM 中,却仍不可见;第二行只有在 CSS 状态切换后才输出。因此等待用户界面上的可见内容时,应直接等待 visibility_of_element_located,不要先 find_element 再固定休眠。

优先用定位器处理动态重渲染

visibility_of_element_located((By.ID, "submit")) 接收定位器,并在轮询过程中重新查找目标。对 React、Vue 等会替换 DOM 节点的页面,这通常比先保存一个旧的 WebElement 再等待 visibility_of(element) 更稳妥,因为旧节点可能在重渲染后变成 stale。

可复用的写法是把定位器保存为元组,例如 submit_locator = (By.ID, "submit"),然后在等待、点击和断言中复用同一定位规则。定位器本身应尽量使用稳定的 id、name 或测试专用属性,避免依赖会随样式改版变化的长 CSS 层级。

可见之后再验证业务状态

元素刚变可见时,文本或属性未必已经更新到最终值。若页面会先显示空容器,再异步填入内容,应继续等待真正需要的业务条件,例如 text_to_be_present_in_element(locator, "保存成功"),而不是把“可见”当成全部完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

等待元素可见

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

登录哪都通