自动化测试 / 系统课时

编写自定义等待条件

编写自定义等待条件

内置 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。

python
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()

预期输出

text
业务状态: 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 把真实脚本错误全部吞掉。

当条件需要“全部满足”时,也不要把多个不相关业务检查塞进一个巨型函数。可以分别等待关键状态,例如先等遮罩消失,再等提交按钮可点击;这样超时时能直接看出卡在哪个状态,测试报告也更容易定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写自定义等待条件

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

登录哪都通