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

Documentationbreadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/browserbreadcrumb arrow Framebreadcrumb arrow locator(selector[, options])
Open source

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.

ParameterTypeDefaultDescription
selectorstring''A selector to use when resolving a DOM element.
optionsobjectnull
options.hasTextstring or RegExpnullMatches only elements that contain the specified text. String or regular expression. Optional.
options.hasNotTextstring or RegExpnullMatches only elements that do not contain the specified text. String or regular expression. Optional.

Returns

TypeDescription
LocatorThe element Locator associated with the frame.

Example

JavaScript 
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();
  }
}