Page.focus() 方法

¥Page.focus() method

此方法获取带有 selector 的元素并聚焦它。如果没有与 selector 匹配的元素，该方法将抛出错误。

¥This method fetches an element with selector and focuses it. If there's no element matching selector, the method throws an error.

签名

¥Signature

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

参数

¥Parameters

范围	类型	描述
selector	string	要查询页面的 selector。CSS 选择器 可以按原样传递，Puppeteer 特定的选择器语法 允许通过 text、a11y 角色和名称、xpath 和 跨影子根组合这些查询 进行查询。或者，你可以使用 prefix 指定选择器类型。如果有多个元素满足选择器，则第一个元素将获得焦点。

Returns:

Promise<void>

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

¥Promise which resolves when the element matching selector is successfully focused. The promise will be rejected if there is no element matching selector.

备注

¥Remarks

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

¥Shortcut for page.mainFrame().focus(selector).