Add docs for locator.clear

Author: ankur22

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

@@ -19,6 +19,7 @@ Locator can be created with the [page.locator(selector[, options])](https://graf
 | Method                                                                                                                                                            | Description                                                                                                             |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
 | [locator.check([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/locator/check) <BWIPT id="471"/>                       | Select the input checkbox.                                                                                              |
+| [locator.clear([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/locator/clear)                                         | Clears text boxes and input fields of any existing values.                                                              |
 | [locator.click([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/locator/click) <BWIPT id="471"/>                       | Mouse click on the chosen element.                                                                                      |
 | [locator.dblclick([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/locator/dblclick) <BWIPT id="471"/>                 | Mouse double click on the chosen element.                                                                               |
 | [locator.dispatchEvent(type, eventInit, [options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/locator/dispatchevent)        | Dispatches HTML DOM event types e.g. `'click'`.                                                                         |

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

@@ -0,0 +1,52 @@
+---
+title: 'clear([options])'
+excerpt: 'Browser module: locator.clear method'
+---
+
+# clear([options])
+
+Clears text boxes and input fields (`input`, `textarea` or `contenteditable` elements) of any existing values.
+
+<TableWithNestedRows>
+
+| Parameter           | Type    | Default | Description                                                                                                                                                                                                                                                                                                                                   |
+| ------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| options             | object  | `null`  |                                                                                                                                                                                                                                                                                                                                               |
+| options.force       | boolean | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`).                                                                                                                                                                                                                                                 |
+| options.noWaitAfter | boolean | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete.                                                                                                                                                                                                                                    |
+| options.timeout     | number  | `30000` | Maximum time in milliseconds. Pass `0` to disable the timeout. Default is overridden by the `setDefaultTimeout` option on [BrowserContext](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/browsercontext/) or [Page](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-experimental/browser/page/). |
+
+</TableWithNestedRows>
+
+### Example
+
+{{< code >}}
+
+```javascript
+import { browser } from 'k6/experimental/browser';
+
+export const options = {
+  scenarios: {
+    browser: {
+      executor: 'shared-iterations',
+      options: {
+        browser: {
+          type: 'chromium',
+        },
+      },
+    },
+  },
+};
+
+export default async function () {
+  const page = browser.newPage();
+
+  await page.goto('https://test.k6.io/browser.php');
+
+  page.locator('#text1').clear();
+
+  page.close();
+}
+```
+
+{{< /code >}}