Add locator.count docs page

docs/sources/k6/next/javascript-api/k6-browser/locator/_index.md

@@ -21,6 +21,7 @@ Locator can be created with the [page.locator(selector[, options])](https://graf
 | [check([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/check) {{< docs/bwipt id="471" >}}                       | Select the input checkbox.                                                                                              |
 | [clear([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/clear)                                                   | Clears text boxes and input fields of any existing values.                                                              |
 | [click([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/click) {{< docs/bwipt id="471" >}}                       | Mouse click on the chosen element.                                                                                      |
+| [count()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/count)                                                            | Returns the number of elements matching the selector.                                                                   |
 | [dblclick([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/dblclick) {{< docs/bwipt id="471" >}}                 | Mouse double click on the chosen element.                                                                               |
 | [dispatchEvent(type, eventInit, [options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/dispatchevent)                  | Dispatches HTML DOM event types e.g. `'click'`.                                                                         |
 | [fill(value, [options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/fill)                                              | Fill an `input`, `textarea` or `contenteditable` element with the provided value.                                       |

docs/sources/k6/next/javascript-api/k6-browser/locator/count.md

@@ -0,0 +1,56 @@
+---
+title: 'count()'
+description: 'Browser module: locator.count method'
+---
+
+# 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
+
+{{< code >}}
+
+```javascript
+import { expect } from 'https://jslib.k6.io/k6-testing/0.4.0/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();
+}
+```
+
+{{< /code >}}