STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/k6/latest/javascript-api/k6-browser/locator/count.md (append .md) or send Accept: text/markdown to /docs/k6/latest/javascript-api/k6-browser/locator/count/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

JavaScript API

k6/browser

Locator

count()

Open source

count()

Returns the number of elements matching the selector. This does not wait for actionability checks (whether the matching elements are visible, stable, and enabled). If the return value from count doesn’t match the expected count, then you should manually retry the API call.

Returns

Type	Description
`Promise<number>`	A promise which resolves with the number of elements matching the selector.

Example

import { expect } from 'https://jslib.k6.io/k6-testing/0.6.1/index.js';
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();
  await page.goto('https://quickpizza.grafana.com/login');

  const expected = 3;
  let match = false;
  for (let i = 0; i < 5; i++) {
    match = await page.locator('input').count();
    if (match == expected) {
      break;
    }
  }

  expect(match).toEqual(expected);

  await page.close();
}