Puppeteer 中文文档v25.8.0

Page.focus() 方法

此方法获取与 selector 匹配的元素并使其获得焦点。如果没有与 selector 匹配的元素,该方法会抛出错误。

签名

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

参数

参数

类型

说明

selector

string

用于查询页面的选择器CSS 选择器可以直接传入,Puppeteer 特有的选择器语法则允许按文本无障碍角色和名称xpath进行查询,并支持跨 shadow root 组合这些查询。另外,你也可以使用前缀来指定选择器类型。如果有多个元素满足该 selector,将聚焦第一个。

返回值:

Promise<void>

当匹配 selector 的元素被成功聚焦时,该 Promise 会 resolve。如果没有匹配 selector 的元素,该 Promise 将被拒绝。

备注

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