自动化测试 / 系统课时
编写自定义等待条件
编写自定义等待条件
内置 Expected Conditions 覆盖不了所有业务状态时,可以把“什么时候算完成”封装成可调用条件交给 WebDriverWait。这样测试按状态结束,而不是猜等待秒数,并且能单独控制超时、轮询频率和超时提示。
学习目标
- 编写一个返回真值或
False的自定义等待条件。 - 使用
timeout与poll_frequency控制等待上限和检查间隔。 - 在超时后根据业务状态定位失败原因,而不是继续追加固定休眠。
自定义条件返回什么
WebDriverWait(...).until(condition) 会反复调用条件对象,并把当前 driver 作为参数传入。条件未满足时返回 False;满足时最好返回后续真正要用的对象,例如 WebElement,这样等待结束后无需再次定位元素。
例如订单状态需要从 PROCESSING 变为 DONE,条件可以同时完成“定位状态元素、读取文本、判断值”三件事。若只返回 True,后续仍需再次调用 find_element;直接返回元素更紧凑,也能减少一次重复查询。

封装业务状态检查
下面示例适用于 Selenium Python 4.x。页面先显示 PROCESSING,1.2 秒后由 JavaScript 改成 DONE;自定义条件类只有在状态匹配时才返回元素。示例使用本地临时 HTML,不依赖外部网站,但需要本机可启动 Chrome。
from pathlib import Path
from tempfile import TemporaryDirectory
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
class OrderStateIs:
def __init__(self, locator, expected_text):
self.locator = locator
self.expected_text = expected_text
def __call__(self, driver):
# 未达到目标状态时返回 False,WebDriverWait 会继续轮询。
element = driver.find_element(*self.locator)
if element.text == self.expected_text:
return element
return False
html = """<!doctype html>
<html>
<body>
<span id="status">PROCESSING</span>
<script>
setTimeout(() => {
document.getElementById("status").textContent = "DONE";
}, 1200);
</script>
</body>
</html>
"""
with TemporaryDirectory() as temp_dir:
page = Path(temp_dir) / "wait.html"
page.write_text(html, encoding="utf-8")
driver = webdriver.Chrome()
try:
driver.get(page.as_uri())
wait = WebDriverWait(driver, timeout=4, poll_frequency=0.2)
status = wait.until(
OrderStateIs((By.ID, "status"), "DONE"),
message="order status did not become DONE",
)
print(f"业务状态: {status.text}")
finally:
driver.quit()预期输出
业务状态: DONE这里 timeout=4 表示最多等待 4 秒,poll_frequency=0.2 表示两次条件调用之间约间隔 200 毫秒。页面约 1.2 秒达到目标时,等待会立即结束,不会继续耗满 4 秒。
选择轮询频率和超时
轮询频率要跟状态变化速度匹配。按钮可点击、DOM 更新这类前端状态通常可从 0.2~0.5 秒开始;后台批处理每几秒才更新一次时,没有必要把轮询压到 0.05 秒,否则会制造大量无意义的 WebDriver 命令。
超时应覆盖正常最慢路径再留少量余量。例如接口常见完成时间为 0.8~2.5 秒,偶发到 3.2 秒,可以先设 timeout=5;如果正常就需要 20 秒,不应简单设 60 秒掩盖问题,而应确认等待的是不是正确状态。
处理条件中的不稳定元素
自定义条件每轮都重新定位元素,通常比把旧 WebElement 长时间缓存后反复读取更稳,因为前端框架可能重建节点。若业务页面频繁替换 DOM,可在条件内部捕获明确可恢复的异常并返回 False,但不要用裸 except Exception 把真实脚本错误全部吞掉。
当条件需要“全部满足”时,也不要把多个不相关业务检查塞进一个巨型函数。可以分别等待关键状态,例如先等遮罩消失,再等提交按钮可点击;这样超时时能直接看出卡在哪个状态,测试报告也更容易定位。