Open source

waitForSelector(selector[, options])


Use locator.waitFor([options]) instead.

Waits for the element to be present in the DOM and to be visible.

selectorstringA selector to query the element.
optionsobjectnullOptional settings.
options.statestringvisibleThe state to wait for. This can be one of visible, hidden, stable, enabled, disabled, or editable.
options.strictbooleanfalseIf set to true, the method will throw an error if the element is not found.
options.timeoutnumber30000Maximum time in milliseconds. Pass 0 to disable the timeout. Default is overridden by the setDefaultTimeout option on BrowserContext or Page.


Promise<ElementHandle | null>A Promise that fulfills with the ElementHandle when the element is found.


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("");

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

  await page.close();