鼠标悬停在网页元素上
指令说明
将鼠标指针移动到网页中的文字/按钮/图片/链接等上面。该指令会自动激活元素所属的网页。
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 网页对象 | WebPage | 悬停到该网页的元素上 |
| 网页元素 | WebElement 或 ElementDescriptor | 悬停到该元素上,可以选择捕获的网页元素也可以选择获取网页元素、获取网页相似元素、获取网页关联元素等指令获取到网页元素 |
| 悬停方式 | 枚举项 | 鼠标悬停、静默悬停、CDP静默悬停 |
| 鼠标指针位置 | 枚举项 | 随机、中间,控制鼠标指针在网页元素上的位置 |
| 等待元素出现时长 | float | 若元素未出现则一直等待,直到元素出现再悬停,若超过最长等待时间后元素仍未出现则触发错误,单位:秒 |
指令输出参数
无
类型定义参考
悬停方式比较
| 悬停方式 | 说明 |
|---|---|
| 鼠标悬停 | 自动把元素所属浏览器窗口前置并切换到元素所属的网页,然后移动鼠标指针到被点击元素上 |
| 静默悬停 | 不移动鼠标,直接通过JS代码触发悬停。若被悬停元素被其他元素遮挡可以尝试使用静默悬停。不前置浏览器窗口,即使浏览器窗口在屏幕外或者被其他窗口遮挡仍旧可以悬停。 |
| CDP静默悬停 | 不移动鼠标,直接通过CDP协议悬停,类似鼠标悬停但不需要鼠标。不前置浏览器窗口,即使浏览器窗口在屏幕外或者被其他窗口遮挡仍旧可以悬停。 |
提示
- 需要先安装曲辕RPA浏览器插件
- CDP静默悬停要求:曲辕RPA >= 7.7.0,浏览器插件 >= 2.4.0
- 如何捕获及编辑元素属性参考 捕获及编辑网页元素属性
示例
点击JD的待处理订单。需要先把鼠标移动到 我的京东 上,这时会出现悬浮窗,然后点击悬浮窗中的待处理订单

常见问题
参考 网页操作常见问题