自动化测试 / 系统课时
使用显式等待
使用显式等待
显式等待用于“等到某个明确状态成立再继续”,例如按钮可点击、标题变化或异步区域出现。相比固定 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。
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()预期输出
保存
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 秒等待覆盖全部步骤。这样失败时能直接知道卡在哪个状态,测试执行时间也不会被固定休眠拖长。