自动化测试 / 系统课时

理解页面同步问题

理解页面同步问题

Selenium 失败并不一定是定位器写错了;更常见的情况是测试代码已经执行到下一步,而页面仍在异步更新。学会区分“页面加载完成”“元素进入 DOM”和“元素真正可操作”,就能先判断失败属于同步问题,再选择合适的等待条件。

学习目标

  • 解释 WebDriver 与页面异步更新之间为什么会出现竞态。
  • 根据失败现象判断应该等待页面、元素还是业务状态。
  • 用一个可运行示例复现“页面已完成但元素尚未出现”的问题。

页面完成不代表业务状态就绪

默认页面加载策略为 normal 时,导航通常会等到文档达到 readyState=complete 再把控制权交还给测试代码。但这个状态只说明当前文档及其加载流程达到完成点,JavaScript 仍可能继续发请求、启动定时任务或重新渲染组件,因此目标元素可能还不存在。

WebDriver 与页面异步更新产生竞态的时序

下面的示例不依赖外部网站。页面先加载一个空容器,随后由脚本在 1.5 秒后插入按钮,因此可以稳定复现“文档已完成、按钮未出现”的窗口。

python
import time
from urllib.parse import quote

from selenium import webdriver
from selenium.common.exceptions import NoSuchElementException
from selenium.webdriver.common.by import By

html = "<!doctype html><html><body><div id='app'></div></body></html>"
url = "data:text/html;charset=utf-8," + quote(html)

driver = webdriver.Chrome()
try:
    driver.get(url)
    driver.execute_script(
        "setTimeout(() => {"
        "const b = document.createElement('button');"
        "b.id = 'save-btn'; b.textContent = 'Save';"
        "document.querySelector('#app').appendChild(b);"
        "}, 1500);"
    )

    print("readyState:", driver.execute_script("return document.readyState"))
    try:
        driver.find_element(By.ID, "save-btn")
        print("immediate lookup: found")
    except NoSuchElementException:
        print("immediate lookup: not ready")

    time.sleep(2)
    print("after 2s:", driver.find_element(By.ID, "save-btn").text)
finally:
    driver.quit()

预期输出:

text
readyState: complete
immediate lookup: not ready
after 2s: Save

这个结果证明失败点不在 By.ID。第一次查找发生在 DOM 变更之前,所以默认 0 秒的元素查找等待会立即抛出 NoSuchElementException;两秒后使用同一个定位器即可成功。

先判断究竟要等什么

同步控制应围绕“下一条命令真正依赖的条件”展开,而不是统一等待固定秒数。实际排查时,可以把失败按下面几类归位,再决定后续使用隐式等待还是显式条件等待。

现象 真正缺少的条件 可检查的信号
NoSuchElementException 元素尚未进入 DOM 同一定位器稍后能找到元素
元素已找到但不可见 样式或动画尚未结束 is_displayed() 仍为 False
元素可见但操作失败 遮罩、禁用状态或重渲染未结束 is_enabled()、页面遮罩与 DOM 是否变化
文本仍是旧值 后台请求或前端状态尚未回写 text、value 或业务属性尚未达到目标值
旧元素突然失效 框架重建了节点 再次定位后能获得新的元素引用

例如“点击保存后等待按钮出现”和“点击保存后等待提示文字变成 Saved”不是同一个条件。前者只关心节点是否存在,后者关心业务状态是否已更新;即使按钮早已在 DOM 中,也不能证明保存流程完成。

固定休眠只适合复现,不适合长期同步

time.sleep(2) 会无条件暂停两秒:页面 100 毫秒就准备好时仍然浪费剩余时间,页面需要 2.5 秒时又会失败。它适合像上面的教学示例那样制造清晰时间窗口,或临时验证“多等一会儿是否能通过”,不适合作为稳定测试的默认方案。

排查同步问题时,先记录触发动作、失败命令和真正需要满足的状态。若只是元素“稍晚出现”,可以用下一课的隐式等待覆盖元素查找;若需要等待可见、可点击、文本变化或遮罩消失,则应使用针对条件的等待,而不是继续增加固定休眠时间。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解页面同步问题

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

登录哪都通