Puppeteer 中文文档v25.8.0

Page.hover() 方法

此方法获取与 selector 匹配的元素,如有需要会将其滚动到视图中,然后使用 Page.mouse 悬停到元素中心。如果没有与 selector 匹配的元素,该方法会抛出错误。

签名

class Page {
  hover(selector: string): Promise<void>;
}

参数

参数

类型

说明

selector

string

用于查询页面的 selectorCSS 选择器 可以直接传入,Puppeteer 特有的选择器语法 允许按 texta11y role 和 namexpath 查询,并支持跨 shadow roots 组合这些查询。此外,你也可以使用前缀来指定选择器类型。如果有多个元素满足 selector,将悬停第一个元素。

返回值:

Promise<void>

当与 selector 匹配的元素成功悬停时,Promise 将解析。如果没有与 selector 匹配的元素,Promise 将被拒绝。

备注

page.mainFrame().hover(selector) 的快捷方式。