自动化测试 / 系统课时

使用显式等待

使用显式等待

显式等待用于“等到某个明确状态成立再继续”,例如按钮可点击、标题变化或异步区域出现。相比固定 sleep,它会在条件满足时立即放行,并在超时后明确失败,更适合处理加载速度不稳定的页面。

学习目标

  • 使用 WebDriverWait 与 until 等待指定页面条件。
  • 根据操作目的选择 presence、visibility、clickable 等条件。
  • 正确设置超时与轮询间隔,并识别等待策略混用带来的问题。

明确等待条件而不是固定秒数

显式等待由“最长等多久”和“等什么条件”两部分组成。WebDriverWait(driver, 5) 表示最多等待 5 秒;until(...) 会反复检查条件,条件返回真值后立即结束,否则超时抛出 TimeoutException。当前 Selenium Python 的默认轮询间隔为 0.5 秒。

目标 Expected Condition 条件成立时
元素进入 DOM presence_of_element_located 返回 WebElement,不保证可见
元素可见 visibility_of_element_located 返回可见的 WebElement
元素可点击 element_to_be_clickable 元素可见且 enabled
标题包含文本 title_contains 返回 True

需要点击按钮时,不要只等“存在”;节点已经进入 DOM 但仍隐藏或禁用时,点击仍会失败。把等待条件直接写成下一步操作真正需要的状态,可以减少偶发失败。

用 WebDriverWait 等到按钮可点击

下面示例创建一个本地 data: 页面,1.2 秒后才向 DOM 添加按钮。等待最长 5 秒,每 0.2 秒检查一次;按钮出现且可点击后立即点击,再等待页面写入完成标记。示例适用于 Selenium 4.x Python API。

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">
<script>
setTimeout(() => {
  const button = document.createElement("button");
  button.id = "save";
  button.textContent = "保存";
  button.onclick = () => document.body.dataset.saved = "yes";
  document.body.appendChild(button);
}, 1200);
</script>
"""

driver = webdriver.Chrome()

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

    button = wait.until(
        EC.element_to_be_clickable((By.ID, "save"))
    )
    button.click()

    saved = wait.until(
        lambda d: d.find_element(By.TAG_NAME, "body")
        .get_attribute("data-saved") == "yes"
    )

    print(button.text)
    print(saved)
finally:
    driver.quit()

预期输出

text
保存
True

这里没有写 time.sleep(1.2),所以页面若 0.8 秒就准备好,测试不会额外等待;页面若在 5 秒内始终不满足条件,等待会以超时结束,而不是继续执行错误步骤。

设置超时和轮询频率

WebDriverWait 常用参数是 timeout、poll_frequency 与 ignored_exceptions。timeout 是总上限,单位为秒;poll_frequency 是两次检查之间的间隔,默认 0.5 秒;默认会忽略查找过程中的 NoSuchElementException,继续轮询直到超时。

实际项目可先用 5~10 秒作为普通交互等待上限,对明确的慢操作单独提高到 20~30 秒,而不是把全站所有等待统一放大。轮询通常保留默认值即可;只有条件变化很快且确实需要更及时响应时,再降低到 0.2~0.3 秒,避免大量无意义查询。

让超时信息能定位问题

生产测试中不要只捕获 TimeoutException 后忽略。至少把等待对象、条件和页面状态写进异常信息,或者让异常直接向测试框架冒泡。until 的第二个参数可传入消息,例如 wait.until(condition, "保存按钮 5 秒内未变为可点击"),超时时会把这段信息带入异常。

如果同一个页面有多个异步阶段,应分别等待“列表加载完成”“保存按钮可点击”“成功提示出现”,而不是用一个 30 秒等待覆盖全部步骤。这样失败时能直接知道卡在哪个状态,测试执行时间也不会被固定休眠拖长。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用显式等待

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

登录哪都通