locator(selector[, options])

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 a DOM element.
options	object	`null`
options.hasText	string or RegExp	`null`	Matches only elements that contain the specified text. String or regular expression. Optional.
options.hasNotText	string or RegExp	`null`	Matches only elements that do not contain the specified text. String or regular expression. Optional.

Returns

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

Example

import { browser } from 'k6/browser';

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

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

  try {
    await page.goto('https://quickpizza.grafana.com');

    // Get the mainframe of the page
    const frame = page.mainFrame();

    // Create a locator with text filtering options
    const submitButton = frame.locator('button', { hasText: 'Pizza, Please!' });
    await submitButton.click();
  } finally {
    await page.close();
  }
}