waitForSelector(selector[, options])

警告
请改用locator.waitFor([options])。

等待元素出现在 DOM 中并可见。

参数	类型	默认值	描述
selector	string		用于查询元素的 CSS 选择器。
options	object	`null`	可选设置。
options.state	string	`visible`	等待的状态。可以是 `visible`（可见）、`hidden`（隐藏）、`stable`（稳定）、`enabled`（启用）、`disabled`（禁用）或 `editable`（可编辑）之一。
options.strict	boolean	`false`	如果设置为 `true`，如果找不到元素，方法将抛出错误。
options.timeout	number	`30000`	最大等待时间（毫秒）。传递 `0` 可禁用超时。默认值会被 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。

返回值

类型	描述
`Promise<ElementHandle \| null>`	找到元素时，Promise 会解析为 ElementHandle。

示例

import { browser } from 'k6/browser';

export const options = {
  scenarios: {
    browser: {
      executor: 'shared-iterations',
      options: {
        browser: {
          type: 'chromium',
        },
      },
    },
  },
};

export default async function () {
  const page = await browser.newPage();
  await page.goto("https://test.k6.io");

  const element = await page.$(".header");
  const el = await element.waitForSelector(".title");
  // ... do something with the element

  await page.close();
}