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

Documentation

locator(selector)

Open source

locator(selector)

The method returns an element Locator. Locators resolve to the element when the action takes place, which means locators can span over navigations where the underlying dom changes.

Parameter	Type	Default	Description
selector	string	`''`	A selector to use when resolving DOM element.

Returns

Type	Description
Locator	The element `Locator` associated with the page.

Example

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 textbox = page.locator('#text1');
  await textbox.focus();
}