focus(selector[, options])
警告
请改用基于 locator 的
locator.focus([options])
方法。
此方法根据 selector
查找元素并使其获得焦点。
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
selector | string | '' | 用于查找元素的 selector。如果多个元素满足 selector,将使用第一个匹配的元素。 |
options | object | null | |
options.strict | boolean | false | 当为 true 时,要求 selector 只能匹配一个元素。如果给定的 selector 匹配多个元素,则调用会抛出异常。 |
options.timeout | number | 30000 | 最大超时时间(毫秒)。传入 0 可禁用超时。默认值会被 BrowserContext 或 Page 的 setDefaultTimeout 选项覆盖。 |
返回值
类型 | 描述 |
---|---|
Promise<void> | 当元素获得焦点时 fulfills 的 Promise。 |