Add FrameLocator.locator() method documentation

Author: inancgumus

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

@@ -0,0 +1,15 @@
+---
+title: "FrameLocator"
+description: "Browser module: FrameLocator Class"
+weight: 09
+---
+
+# FrameLocator
+
+FrameLocator represents a way to find element(s) in an iframe. Frames can be nested, and this locator supports selecting a frame element and then working with it.
+
+A FrameLocator can be created with the [locator.contentFrame()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/) method.
+
+| Method                                                                                                                                                 | Description                                                                                                             |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| [locator(selector[, options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/framelocator/locator)                             | Returns a new chained `locator` for the given `selector` within the frame.                                             |

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

@@ -0,0 +1,61 @@
+---
+title: 'locator(selector[, options])'
+description: 'Browser module: frameLocator.locator(selector[, options]) method'
+---
+
+# locator(selector[, options])
+
+The method returns an element [Locator](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/). Locators resolve to the element when the action takes place, which means locators can span over navigations where the underlying dom changes.
+
+<TableWithNestedRows>
+
+| Parameter           | Type             | Default | Description                                                                                                                                                                                                                           |
+| ------------------- | ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| selector            | string           | `''`    | A selector to use when resolving 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.                                                                                                                                |
+
+</TableWithNestedRows>
+
+### Returns
+
+| Type                                                                                   | Description                                      |
+| -------------------------------------------------------------------------------------- | ------------------------------------------------ |
+| [Locator](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/locator/) | The element `Locator` associated with the frame. |
+
+### 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');
+
+  // Get a locator for an iframe element
+  const frameLocator = page.locator('iframe').contentFrame();
+
+  // Create a locator within the frame with text filtering options
+  const submitButton = frameLocator.locator('button', { hasText: 'Submit Order' });
+  await submitButton.click();
+}
+```
+
+{{< /code >}}