waitForSelector(selector[, options])
注意
建议使用断言可见性的 Web 断言或基于 locator 的
locator.waitFor([options])方法。
当由 selector 指定的元素满足 state 选项时返回。
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| selector | string | '' | 用于搜索元素的 selector。如果存在多个满足条件的元素,将使用第一个元素。 |
| options | object | null | |
| options.state | string | visible | 可以是 attached, detached, visible 或 hidden。有关详细信息,请参阅元素状态。 |
| options.strict | boolean | false | 当为 true 时,此调用要求 selector 必须解析为单个元素。如果给定的 selector 解析出多个元素,则调用将抛出异常。 |
| options.timeout | number | 30000 | 最大等待时间(毫秒)。传入 0 可禁用超时。默认值会被 BrowserContext 或 Page 上的 setDefaultTimeout 选项覆盖。 |
元素状态
元素状态可以是以下之一:
'attached'- 等待元素出现在 DOM 中。'detached'- 等待元素不在 DOM 中。'visible'- 等待元素具有非空边界框且没有visibility:hidden样式。'hidden'- 等待元素从 DOM 分离,或具有空边界框,或具有visibility:hidden样式。
返回值
| 类型 | 描述 |
|---|---|
Promise<ElementHandle | null> | 当找到匹配的元素时,该 Promise 以 ElementHandle 实现;如果未找到元素,则以 null 实现。 |


