Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current 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/experimental/browser';

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

export default async function () {
  const page = browser.newPage();

  await page.goto('https://test.k6.io/browser.php');
  const textbox = page.locator('#text1');
  textbox.focus();
}