跳到主要内容
版本:23.11.1

Page.focus() 方法

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

签名

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

参数

参数

类型

描述

selector

string

用于查询页面的选择器。可以直接传递CSS选择器,而Puppeteer特定的选择器语法允许通过文本a11y 角色和名称以及xpath跨阴影根组合这些查询进行查询。或者,可以使用前缀来指定选择器类型。如果存在多个满足选择器的元素,则第一个元素将获得焦点。

返回

Promise<void>

当成功聚焦匹配选择器的元素时,Promise 会被解析。如果没有匹配选择器的元素,Promise 将被拒绝。

备注

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