自动化测试 / 系统课时
实现稳定等待与断言
实现稳定等待与断言
动态页面最常见的偶发失败不是“元素永远不存在”,而是测试代码比页面状态变化更早执行。本篇用一个本地异步页面演示状态驱动等待:先等到下一步真正需要的条件成立,再对最终业务结果做断言,而不是用固定休眠碰运气。
学习目标
- 根据下一步操作选择存在、可见、可点击、消失或失效等明确等待条件。
- 用
WebDriverWait编写可复用的业务状态条件,避免time.sleep()。 - 把“同步条件”和“业务断言”分开,得到可定位的失败信息。
按下一步依赖选择等待条件
显式等待应描述“下一行代码依赖什么”,而不是随手统一等 3 秒。Selenium Python 的 WebDriverWait 默认轮询间隔是 0.5 秒;示例会改为 0.2 秒,让短异步操作更快被观察到,但轮询越频繁,浏览器命令也越多。
| 下一步要做什么 | 更合适的条件 | 易错做法 |
|---|---|---|
| 只需要节点已进入 DOM | presence_of_element_located |
把“存在”误当成“可见” |
| 要输入文本 | visibility_of_element_located |
找到隐藏节点后直接 send_keys |
| 要点击按钮 | element_to_be_clickable |
只检查 is_displayed() |
| 等旧节点被重新渲染替换 | staleness_of |
继续使用旧 WebElement |
| 等加载遮罩消失 | invisibility_of_element_located |
固定 sleep(2) |
不要在同一会话里把较长的 implicit wait 与 explicit wait 混用。隐式等待会参与元素查找,叠加后实际超时时间可能比代码表面看到的更长,排查失败也更困难。
把等待写成业务状态条件
下面给出完整测试文件内容。它是项目文件片段示例,需要保存为 test_stable_wait.py,再由下一节的 pytest 命令执行;测试会在临时目录生成本地 HTML,点击 Save 后先进入 saving,700 ms 后进入 saved。等待条件读取稳定的 data-state,而不是依赖展示文案。

from pathlib import Path
import pytest
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
HTML = '''<!doctype html>
<meta charset="utf-8">
<button id="save">Save</button>
<p id="status" data-state="idle">Idle</p>
<script>
const save = document.querySelector("#save");
const status = document.querySelector("#status");
save.addEventListener("click", () => {
save.disabled = true;
status.dataset.state = "saving";
status.textContent = "Saving";
setTimeout(() => {
status.dataset.state = "saved";
status.textContent = "Saved";
save.disabled = false;
}, 700);
});
</script>
'''
@pytest.fixture
def page_url(tmp_path: Path) -> str:
page = tmp_path / "dynamic-save.html"
page.write_text(HTML, encoding="utf-8")
return page.as_uri()
def attribute_to_be(locator, name: str, expected: str):
# 返回 WebElement,便于等待结束后直接用于断言。
def _predicate(driver):
element = driver.find_element(*locator)
value = element.get_dom_attribute(name)
return element if value == expected else False
return _predicate
def test_wait_for_business_state(page_url: str):
options = Options()
options.add_argument("--headless=new")
driver = webdriver.Chrome(options=options)
try:
driver.get(page_url)
wait = WebDriverWait(driver, 5, poll_frequency=0.2)
save = wait.until(EC.element_to_be_clickable((By.ID, "save")))
save.click()
status = wait.until(
attribute_to_be((By.ID, "status"), "data-state", "saved"),
message="status did not reach saved",
)
# 等待解决时序问题;断言负责判断最终业务结果是否正确。
assert status.text == "Saved"
assert driver.find_element(By.ID, "save").is_enabled()
print(f"status={status.text}, button_enabled=True")
finally:
driver.quit()这段代码没有等待“700 ms”这个时长,而是等待 data-state="saved" 这个结果。即使把页面内部延迟从 700 ms 改成 1200 ms,只要仍小于 5 秒,测试逻辑无需修改。
运行并核对结果
把代码保存为 test_stable_wait.py,确保环境中已安装 Selenium 4.x、pytest 8.x 或 9.x 且本机有 Chrome,然后执行:
python -m pytest -q -s test_stable_wait.py预期输出:
status=Saved, button_enabled=True
.
1 passed in <TIME>s<TIME> 是动态值。要验证等待确实有效,可以把 HTML 中 700 改成 1200 再运行,测试仍应通过;如果改成 6000,则 5 秒上限会先触发 TimeoutException,这正是等待条件没有在预算内满足时应出现的失败。
断言最终结果而不是动作完成
click() 没抛异常只能证明 WebDriver 发起并完成了点击交互,不能证明保存成功。稳定用例通常先等待一个可观测的完成信号,再断言用户真正关心的结果。
例如保存订单时,可把等待条件设为状态元素的 data-state="saved"、成功提示出现或页面跳到详情 URL;断言则检查订单编号、金额和状态文字。不要把“按钮已点击”或“spinner 消失”当成业务成功,它们最多只是同步信号。
排查偶发超时
出现 TimeoutException 时,先检查条件是否选错,再考虑超时数值。一个 10 秒等待如果永远在等错误的 locator,加到 30 秒只会让失败更慢。
- 记录超时时目标元素是否存在、是否可见,以及关键属性当前值;本例重点看
data-state是否停在saving。 - 如果 DOM 会整块重渲染,避免缓存旧
WebElement,改用 locator 重新查找,或先对旧元素使用staleness_of。 - CI 比本地慢时可以把总上限从 5 秒调整到 10~15 秒,但轮询条件仍应保持具体;不要用固定休眠替代状态判断。
- 若等待 spinner 消失后仍偶发失败,继续找真正的完成信号,例如 URL、结果行、状态属性或服务端返回后才出现的控件。
当等待条件与下一步依赖对齐、断言又只验证最终结果时,失败信息会自然分成两类:超时表示页面没有进入可操作状态,断言失败则表示页面进入了稳定状态但业务结果不正确。