Menu

This is documentation for the next version of K6. For the latest stable release, go to the latest version.

Open source

page.$(selector)

Warning

Use locator-based page.locator(selector) instead.

The method finds an element matching the specified selector within the page. If no elements match the selector, the return value resolves to null. To wait for an element on the page, use locator.waitFor([options]).

Returns

TypeDescription
Promise<ElementHandle | null>A Promise that fulfills with the ElementHandle of the selector when a matching element is found or null.

Example

JavaScript
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/browser.php');
  const text = await page
    .$('#text1')
    .then(text => text.type('hello world'));
}