自动化测试 / 系统课时

执行鼠标悬停

执行鼠标悬停

鼠标悬停常用于展开导航菜单、显示 Tooltip 或触发隐藏按钮。Selenium 不需要直接伪造 mouseover 事件,而是让 WebDriver 把指针真正移动到目标元素,再等待悬停后的界面状态出现。

学习目标

  • 使用 move_to_element() 将鼠标移动到指定元素。
  • 在悬停后等待菜单、提示框等动态内容真正可见。
  • 能定位悬停失效、子菜单消失和目标越界等常见问题。

用 move_to_element 触发悬停

Python 中最直接的写法是 ActionChains(driver).move_to_element(element).perform()。move_to_element() 指定目标,perform() 才执行指针移动。对于 CSS :hover、mouseenter、mouseover 等依赖真实指针位置的页面,这种方式比直接执行 JavaScript 事件更接近用户操作。

下面使用本地页面验证悬停效果。页面中的子菜单初始隐藏,只有指针位于 #menu 上方时才显示。

python
from urllib.parse import quote

from selenium import webdriver
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait

html = '''
<style>
#menu { display: inline-block; padding: 20px; background: #ddd; }
#panel { display: none; margin-top: 8px; padding: 8px; background: #eee; }
#menu:hover #panel { display: block; }
</style>
<div id="menu">Products<div id="panel">Settings</div></div>
'''

driver = webdriver.Chrome()
try:
    driver.get("data:text/html;charset=utf-8," + quote(html))
    menu = driver.find_element(By.ID, "menu")

    # 指针真正移动到菜单元素,触发浏览器的 hover 状态。
    ActionChains(driver).move_to_element(menu).perform()

    panel = WebDriverWait(driver, 3).until(
        EC.visibility_of_element_located((By.ID, "panel"))
    )
    print(panel.text)
finally:
    driver.quit()

预期输出

text
Settings

如果删除 perform(),动作不会被发送给浏览器,子菜单也不会因为这条 ActionChains 调用而展开。这是排查“代码没有报错但悬停没发生”时首先要检查的地方。

等待悬停后的动态内容

真实站点的菜单往往不是立即出现。常见实现包括 150~300 毫秒 CSS 动画、mouseenter 后异步加载数据,或者先挂载 DOM 再切换可见状态。因此完成鼠标移动后,应等待最终业务状态,而不是固定睡眠若干秒。

如果下一步只是读取 Tooltip 文本,可以等待 visibility_of_element_located;如果下一步要点击子菜单项,则优先等待 element_to_be_clickable。项目中通常把单次 UI 等待上限设为 3~10 秒,例如内部系统可先用 5 秒,再根据真实性能基线调整。

一个实用的检查顺序是:先确认触发元素已经找到,再执行悬停,然后等待子元素从隐藏变为可见,最后才读取或点击。如果菜单 DOM 已存在但 display:none,仅等待 presence_of_element_located 并不能证明悬停成功,因为该条件在菜单隐藏时也可能立即通过。

保持指针处于可交互区域

多级菜单常要求指针从父菜单移动到子菜单的过程中始终留在悬停区域。错误做法是悬停父项后执行会改变指针位置的无关动作,再去寻找子项;某些菜单会在指针离开后立即折叠,导致随后定位到的元素不可见或不可点击。

实际操作可以按“父菜单可见 → move_to_element(parent) → 子菜单可见 → move_to_element(child) → 点击”的顺序执行。若页面有固定顶部栏或遮罩,应先确认目标没有被覆盖。对于很长的页面,还要避免依赖手工计算坐标;优先让 Selenium 根据元素定位移动,而不是用 move_by_offset() 猜测像素距离。

区分真实悬停与 JavaScript 事件注入

有些测试会用 execute_script() 人工派发 mouseover,但这并不等价于用户把鼠标移到元素上。脚本事件可能绕过浏览器的命中测试、真实指针位置以及 CSS :hover 状态,因此适合作为特殊页面的诊断手段,不应作为普通悬停测试的默认实现。

如果 move_to_element() 报 MoveTargetOutOfBoundsException,先检查窗口尺寸、滚动位置以及目标是否仍处于当前浏览上下文;如果动作执行成功但菜单没有出现,则检查页面实际监听的是哪个元素、是否存在遮罩,以及悬停后是否需要额外等待。只有确认真实用户操作本身无法稳定复现时,才应考虑页面实现或浏览器差异,而不是直接改成 JavaScript 注入。

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

目录与阅读设置

阅读设置

17

记录一个想法

执行鼠标悬停

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

登录哪都通