Merge pull request #1986 from grafana/browser/locator-all

k6 browser: add locator.all

Author: AgnesToulet

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

@@ -12,12 +12,13 @@ The Locator API makes it easier to work with dynamically changing elements. Some
 - Helps with writing robust tests by finding an element even if the underlying frame navigates.
 - Makes it easier to work with dynamic web pages and SPAs built with Svelte, React, Vue, etc.
 - Enables the use of test abstractions like the Page Object Model (POM) pattern to simplify and organize tests.
-- `strict` mode is enabled for all `locator` methods, which means that if more than one element matches the given selector it will throw an error.
+- `strict` mode is enabled for all `locator` methods that are expected to target a single DOM element, meaning that if more than one element matches the given selector, an error will be thrown.
 
 Locator can be created with the [page.locator(selector[, options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/locator) method.
 
 | Method                                                                                                                                                 | Description                                                                                                             |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| [all()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/all)                                                                | When multiple elements match the selector, returns an array of `locator`.                                                                         |
 | [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.                                                                                      |

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

@@ -0,0 +1,52 @@
+---
+title: 'all()'
+description: 'Browser module: locator.all method'
+---
+
+# all()
+
+When multiple elements match the selector, returns an array of [Locator](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/), each pointing to their respective element.
+
+### Returns
+
+| Type                                                                                   | Description                                              |
+| -------------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| Array<[Locator](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/)> | An array of `Locator`. |
+
+### Example
+
+{{< code >}}
+
+```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();
+  await page.goto('https://quickpizza.grafana.com/browser.php');
+
+  const options = await page.locator('#numbers-options > option').all();
+  console.log(`Found ${options.length} options.`);
+  
+  for (const option of options) {
+    console.log('Inner text: ', await option.innerText());
+    await option.click();
+  }
+
+  await page.close();
+}
+```
+
+{{< /code >}}