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 实现。 |