自动化测试 / 系统课时

等待文本与属性变化

等待文本与属性变化

AJAX、前端状态管理和异步渲染常让元素先出现,再逐步更新文本、属性或列表数量。本课把这三类变化分别变成显式等待条件,使断言只在页面达到目标状态后执行,而不是靠固定休眠猜测更新时间。

学习目标

  • 使用 Selenium 预置条件等待文本和元素属性包含目标值。
  • 编写自定义条件,等待元素数量精确达到指定值。
  • 区分包含匹配与精确匹配,避免状态尚未正确就提前通过。

文本和属性要等状态而不是等时间

Selenium Python 4.x 提供了常用文本条件。text_to_be_present_in_element(locator, text_) 等待元素文本包含指定字符串;text_to_be_present_in_element_attribute(locator, attribute_, text_) 等待指定属性值包含目标字符串。

例如状态从 Loading 20% 变成 Ready,可以等待文本中出现 Ready;属性从 data-state="loading" 变为 data-state="ready",可以等待属性包含 ready。如果业务要求属性必须完全等于 ready,则需要自定义精确比较条件。

元素数量同样不能混淆。presence_of_all_elements_located 可以等待匹配元素出现,却不会替你验证“正好有 3 个”。需要精确数量时,应明确检查 len(elements) == 3;若需求是至少 3 个,则改为 >= 3。

一次等待三种异步变化

下面示例创建本地 data: 页面:0.5 秒后修改文本,0.9 秒后修改 data-state,1.3 秒后插入 3 个列表项。脚本分别等待三个条件,因此可以直接观察文本、属性和数量等待的差异。

python
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait


def elements_count_to_be(locator, expected_count):
    # 每次轮询都重新定位,适合列表被前端重新渲染的页面。
    def _predicate(driver):
        return len(driver.find_elements(*locator)) == expected_count
    return _predicate


html = """
<!doctype html>
<meta charset="utf-8">
<div id="status" data-state="loading">Loading</div>
<ul id="items"></ul>
<script>
setTimeout(() => {
  document.querySelector("#status").textContent = "Ready";
}, 500);
setTimeout(() => {
  document.querySelector("#status").setAttribute("data-state", "ready");
}, 900);
setTimeout(() => {
  const list = document.querySelector("#items");
  ["A", "B", "C"].forEach(text => {
    const li = document.createElement("li");
    li.className = "item";
    li.textContent = text;
    list.appendChild(li);
  });
}, 1300);
</script>
"""

options = Options()
options.add_argument("--headless")
driver = webdriver.Chrome(options=options)
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))
    wait = WebDriverWait(driver, timeout=5, poll_frequency=0.1)
    status = (By.ID, "status")
    # 先等待可见文本,再等待元素属性更新。
    wait.until(EC.text_to_be_present_in_element(status, "Ready"))
    wait.until(
        EC.text_to_be_present_in_element_attribute(
            status, "data-state", "ready"
        )
    )
    # 内置“元素存在”条件不能表达精确数量,因此使用自定义谓词。
    item_locator = (By.CSS_SELECTOR, "#items .item")
    wait.until(elements_count_to_be(item_locator, 3))
    items = driver.find_elements(*item_locator)
    state = driver.find_element(*status).get_attribute("data-state")
    print(f"text={driver.find_element(*status).text}")
    print(f"data-state={state}")
    print(f"item-count={len(items)}")
finally:
    driver.quit()

预期输出:

text
text=Ready
data-state=ready
item-count=3

这里的 timeout=5 是每次 until 调用的最长等待时间,不代表每一步都固定等待 5 秒。第一个条件约 0.5 秒满足后就会继续,属性和数量也会在各自状态完成时继续,因此总耗时主要由最晚出现的状态决定。

包含匹配和精确匹配不要混用

文本与属性文本预置条件适合“包含目标字符串”的情况。例如等待属性中包含 ready 时,already-ready 也包含这段字符。如果 data-state 是严格枚举值,测试就应该做完整字符串比较,否则错误状态可能被当成成功状态。

片段示例:以下代码接在已有的 driver 会话中,并假定页面存在 id="status" 的元素。

python
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait

status = (By.ID, "status")
wait = WebDriverWait(driver, 10)
# 枚举型属性要求完整值一致,而不是仅包含某段文本。
wait.until(
    lambda d: d.find_element(*status).get_attribute("data-state") == "ready"
)

预期结果:只有 data-state 的完整值等于 ready 时条件才通过;loading-ready、already-ready 都不会通过。若元素更新期间会被前端框架替换,在 lambda 内重新调用 find_element 也能避免长期持有旧节点。

数量条件要先写清验收规则

列表、搜索结果和上传队列经常需要等待数量变化。“至少 3 个”应检查 len(elements) >= 3,“正好 3 个”则检查 len(elements) == 3。两者不能互换,否则页面继续追加第 4 个元素时,测试可能在最终状态形成前就已经通过。

对于会先清空再重建的列表,每次轮询重新调用 find_elements 更可靠。发生超时时,应记录当前数量、文本和关键属性;相比单纯把超时从 5 秒增加到 30 秒,这些状态更能判断问题是页面太慢、定位器错误,还是业务条件根本没有发生。

文本、属性和数量都可以归结为一个明确的页面条件。把预期值写成可检查的谓词后,状态一旦满足测试就立即继续;状态始终不满足时,也能稳定地在超时位置暴露真正的同步问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

等待文本与属性变化

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

登录哪都通