菜单
文档breadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/browserbreadcrumb arrow Framebreadcrumb arrow waitForSelector(selector[, options])
开源

waitForSelector(selector[, options])

注意

建议使用断言可见性的 Web 断言或基于 locator 的 locator.waitFor([options]) 方法。

当由 selector 指定的元素满足 state 选项时返回。

参数类型默认值描述
selectorstring''用于搜索元素的 selector。如果存在多个满足条件的元素,将使用第一个元素。
optionsobjectnull
options.statestringvisible可以是 attached, detached, visiblehidden。有关详细信息,请参阅元素状态
options.strictbooleanfalse当为 true 时,此调用要求 selector 必须解析为单个元素。如果给定的 selector 解析出多个元素,则调用将抛出异常。
options.timeoutnumber30000最大等待时间(毫秒)。传入 0 可禁用超时。默认值会被 BrowserContextPage 上的 setDefaultTimeout 选项覆盖。

元素状态

元素状态可以是以下之一:

  • 'attached' - 等待元素出现在 DOM 中。
  • 'detached' - 等待元素不在 DOM 中。
  • 'visible' - 等待元素具有非空边界框且没有 visibility:hidden 样式。
  • 'hidden' - 等待元素从 DOM 分离,或具有空边界框,或具有 visibility:hidden 样式。

返回值

类型描述
Promise<ElementHandle | null>当找到匹配的元素时,该 Promise 以 ElementHandle 实现;如果未找到元素,则以 null 实现。