自动化测试 / 系统课时

实现稳定等待与断言

实现稳定等待与断言

动态页面最常见的偶发失败不是“元素永远不存在”,而是测试代码比页面状态变化更早执行。本篇用一个本地异步页面演示状态驱动等待:先等到下一步真正需要的条件成立,再对最终业务结果做断言,而不是用固定休眠碰运气。

学习目标

  • 根据下一步操作选择存在、可见、可点击、消失或失效等明确等待条件。
  • 用 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,而不是依赖展示文案。

动态页面中状态驱动等待与业务断言的执行顺序

python
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,然后执行:

bash
python -m pytest -q -s test_stable_wait.py

预期输出:

text
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 秒只会让失败更慢。

  1. 记录超时时目标元素是否存在、是否可见,以及关键属性当前值;本例重点看 data-state 是否停在 saving。
  2. 如果 DOM 会整块重渲染,避免缓存旧 WebElement,改用 locator 重新查找,或先对旧元素使用 staleness_of。
  3. CI 比本地慢时可以把总上限从 5 秒调整到 10~15 秒,但轮询条件仍应保持具体;不要用固定休眠替代状态判断。
  4. 若等待 spinner 消失后仍偶发失败,继续找真正的完成信号,例如 URL、结果行、状态属性或服务端返回后才出现的控件。

当等待条件与下一步依赖对齐、断言又只验证最终结果时,失败信息会自然分成两类:超时表示页面没有进入可操作状态,断言失败则表示页面进入了稳定状态但业务结果不正确。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现稳定等待与断言

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

登录哪都通