From 98560a6d25de5fc820fc76499c8941cff98f21b7 Mon Sep 17 00:00:00 2001
From: AgnesToulet <35176601+AgnesToulet@users.noreply.github.com>
Date: Fri, 1 Aug 2025 15:30:25 +0200
Subject: [PATCH 1/5] Browser: add route-related doc

---
 .../javascript-api/k6-browser/page/_index.md  |  1 +
 .../javascript-api/k6-browser/page/route.md   | 56 ++++++++++++++
 .../javascript-api/k6-browser/route/_index.md | 53 +++++++++++++
 .../javascript-api/k6-browser/route/abort.md  | 51 +++++++++++++
 .../k6-browser/route/continue.md              | 63 ++++++++++++++++
 .../k6-browser/route/fulfill.md               | 75 +++++++++++++++++++
 .../k6-browser/route/request.md               | 61 +++++++++++++++
 7 files changed, 360 insertions(+)
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/page/route.md
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
 create mode 100644 docs/sources/k6/next/javascript-api/k6-browser/route/request.md

diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/_index.md b/docs/sources/k6/next/javascript-api/k6-browser/page/_index.md
index 3b54fddda1..2de7a19d7f 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/page/_index.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/_index.md
@@ -48,6 +48,7 @@ Page provides methods to interact with a single tab in a running web browser. A
 | [opener()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/opener)                                                                  | Returns the `page` that opened the current `page`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | [press(selector, key[, options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/press/)                                           | Focuses the element, and then presses the given `key` on the [Keyboard](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/keyboard).                                                                                                                                                                                                                                                                                                                                                                  |
 | [reload([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/reload/)                                                        | Reloads the current page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| [route(url, handler)](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/route/)                                                        | Adds a route to the page to modify network requests made by that page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | [screenshot([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/screenshot/)                                                | Returns a buffer with the captured screenshot from the web browser.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | [selectOption(selector, values[, options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/selectoption/)                          | Selects one or more options which match the values from a `<select>` element.                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | [setContent(html[, options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/setcontent/)                                          | Sets the supplied HTML string to the current page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
new file mode 100644
index 0000000000..2a66457beb
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
@@ -0,0 +1,56 @@
+---
+title: 'route(url, handler)'
+description: 'Browser module: page.route(url, handler) method'
+---
+
+# route(url, handler)
+
+The method adds a route that allows modifying network requests matching the provided url. The handler is a function taking a [Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/) input that provides functions to continue, fulfill or abort the request. Once routing is enabled, every request matching the url pattern will stall unless one of these functions is called.
+
+When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones.
+
+| Parameter | Type   | Default | Description                                   |
+| --------- | ------ | ------- | --------------------------------------------- |
+| url  | string or Regexp | `''`    | URL to match during routing. |
+| handler  | function([Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/)) | null    | Handler function executed when routing the request. |
+
+### Returns
+
+| Type            | Description                                                                     |
+| --------------- | ------------------------------------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the route is added to the page.                    |
+
+
+### Example
+
+{{< code >}}
+
+```javascript
+import { browser } from 'k6/browser';
+
+export const options = {
+  scenarios: {
+    browser: {
+      executor: 'shared-iterations',
+      options: {
+        browser: {
+          type: 'chromium',
+        },
+      },
+    },
+  },
+};
+
+export default async function () {
+  const page = await browser.newPage();
+
+  // Abort all images requests
+  await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
+    await route.abort();
+  })
+
+  await page.goto('https://quickpizza.grafana.com/');
+}
+```
+
+{{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
new file mode 100644
index 0000000000..1d91613c5d
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
@@ -0,0 +1,53 @@
+---
+title: 'Route'
+description: 'Browser module: Route Class'
+weight: 12
+---
+
+# Route
+
+Route represents a network request intercepted by the [`page.route()`](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/route) function and allows to modify its behavior. Once routing is enabled, every request intercepted by a route will stall unless it's continued, fulfilled or aborted.
+
+When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones.
+
+## Supported APIs
+
+| Method                                                                                                                             | Description                                                                                                                                             |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [abort([errorCode])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/abort) | Aborts the route's request.                                                         |
+| [continue([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/continue) | Continues the request with optional overrides.                                                       |
+| [fulfill([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/fulfill) | Fulfills the request with the given response |
+| [request()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/request) | Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request) object.                       |
+
+### Example
+
+{{< code >}}
+
+```javascript
+import { browser } from 'k6/browser';
+
+export const options = {
+  scenarios: {
+    browser: {
+      executor: 'shared-iterations',
+      options: {
+        browser: {
+          type: 'chromium',
+        },
+      },
+    },
+  },
+};
+
+export default async function () {
+  const page = await browser.newPage();
+
+  // Abort all images requests
+  await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
+    await route.abort();
+  })
+
+  await page.goto('https://quickpizza.grafana.com/');
+```
+
+{{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
new file mode 100644
index 0000000000..24f528d82d
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
@@ -0,0 +1,51 @@
+---
+title: 'abort(errorCode)'
+description: 'Browser module: Route.abort method'
+---
+
+# abort(errorCode)
+
+Aborts the request with the given error code.
+
+| Parameter           | Type             | Default    | Description                                                          |
+| ------------------- | ---------------- | ---------- | -------------------------------------------------------------------- |
+| errorCode           | string           | `'failed'` | Error code when aborting the request. Can be one of the following: `'aborted'`, `'accessdenied'`, `'addressunreachable'`, `'blockedbyclient'`, `'blockedbyresponse'`, `'connectionaborted'`,`'connectionclosed'`, `'connectionfailed'`, `'connectionrefused'`, `'connectionreset'`, `'internetdisconnected'`, `'namenotresolved'`, `'timedout'`, `'failed'`.                                                       |
+
+### Returns
+
+| Type            | Description                                                                     |
+| --------------- | ------------------------------------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the request is aborted.                            |
+
+### Example
+
+{{< code >}}
+
+```javascript
+import { browser } from 'k6/browser';
+
+export const options = {
+  scenarios: {
+    browser: {
+      executor: 'shared-iterations',
+      options: {
+        browser: {
+          type: 'chromium',
+        },
+      },
+    },
+  },
+};
+
+export default async function () {
+  const page = await browser.newPage();
+
+  // Abort all images requests
+  await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
+    await route.abort();
+  })
+
+  await page.goto('https://quickpizza.grafana.com/');
+```
+
+{{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
new file mode 100644
index 0000000000..7be04a5645
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
@@ -0,0 +1,63 @@
+---
+title: 'continue(options)'
+description: 'Browser module: Route.continue method'
+---
+
+# continue(options)
+
+Sends the request to the network with optional overrides.
+
+| Parameter           | Type             | Default | Description                                                          |
+| ------------------- | ---------------- | ------- | -------------------------------------------------------------------- |
+| options             | object           | null    |                                                                      |
+| options.headers     | object           | null    | Request headers.                                                     |
+| options.method      | string           | `''`    | Request method (e.g. GET or POST).                                   |
+| options.postData    | string or Buffer | `''`    | Post data of the request.                                            |
+| options.url         | string           | `''`    | Request URL.                                                         |
+
+### Returns
+
+| Type            | Description                                                                     |
+| --------------- | ------------------------------------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the request is resumed.                            |
+
+### 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();
+
+  try {
+    await page.route(/.*\/api\/pizza/, async function (route) {
+      await route.continue({
+        postData: JSON.stringify({
+          customName: 'My Pizza',
+        }),
+      });
+    });
+
+    await page.goto('https://quickpizza.grafana.com/');
+  } finally {
+    await page.close();
+  }
+}
+```
+
+{{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
new file mode 100644
index 0000000000..ab43eedcba
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
@@ -0,0 +1,75 @@
+---
+title: 'fulfill(options)'
+description: 'Browser module: Route.fulfill method'
+---
+
+# fulfill(options)
+
+Fulfills the request with the given response.
+
+| Parameter           | Type             | Default | Description                                                          |
+| ------------------- | ---------------- | ------- | -------------------------------------------------------------------- |
+| options             | object           | null    |                                                                      |
+| options.body        | string or Buffer | `''`    | Response body.                                                       |
+| options.contentType | string           | `''`    | Same as setting `Content-Type` response header.                      |
+| options.headers     | object           | null    | Response headers.                                                    |
+| options.status      | number           | `200`   | Response status code.                                                |
+
+### Returns
+
+| Type            | Description                                                                     |
+| --------------- | ------------------------------------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the request is fulfilled.                          |
+
+
+### 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();
+
+  try {
+    await page.route(
+      "https://jsonplaceholder.typicode.com/todos/1",
+      async function (route) {
+        await route.fulfill({
+          status: 200,
+          body: JSON.stringify({
+            "id": 1,
+            "title": "Test Todo",
+            "completed": false
+          }),
+          contentType: "application/json",
+          headers: {
+            "Access-Control-Allow-Origin": "*",
+            "Access-Control-Allow-Credentials": "true",
+          },
+        });
+      }
+    );
+
+    await page.goto('https://quickpizza.grafana.com/browser.php');
+  } finally {
+    await page.close();
+  }
+}
+```
+
+{{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/request.md b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
new file mode 100644
index 0000000000..67317298af
--- /dev/null
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
@@ -0,0 +1,61 @@
+---
+title: 'request()'
+description: 'Browser module: Route.request method'
+---
+
+# request()
+
+Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request) object.
+
+### Returns
+
+| Type      | Description           |
+| --------- | --------------------- |
+| `Request` | The `Request` object. |
+
+### 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();
+
+  try {
+    await page.route(/.*\/api\/pizza/, async function (route) {
+      await route.continue(
+        {
+          headers: {
+            ...route.request().headers(),
+            'Content-Type': 'application/json',
+          },
+          postData: JSON.stringify({
+              'customName': 'My Pizza'
+          }),
+        }
+      );
+    });
+
+    await page.goto('https://quickpizza.grafana.com/');
+  } finally {
+    await page.close();
+  }
+}
+```
+
+{{< /code >}}

From 8b7f1563e939da28db20ffccbf58e2f4dd4110bf Mon Sep 17 00:00:00 2001
From: ankur22 <ankur.agarwal@grafana.com>
Date: Wed, 6 Aug 2025 11:57:28 +0100
Subject: [PATCH 2/5] Add code review changes

- Examples updated to work with all route methods against quickpizza.
---
 .../javascript-api/k6-browser/page/route.md   | 53 ++++++++++++---
 .../javascript-api/k6-browser/route/_index.md | 49 ++++++++++++--
 .../javascript-api/k6-browser/route/abort.md  | 23 ++++---
 .../k6-browser/route/continue.md              | 66 ++++++++++++-------
 .../k6-browser/route/fulfill.md               | 62 ++++++++---------
 5 files changed, 172 insertions(+), 81 deletions(-)

diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
index 2a66457beb..53f5342c4b 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
@@ -5,21 +5,20 @@ description: 'Browser module: page.route(url, handler) method'
 
 # route(url, handler)
 
-The method adds a route that allows modifying network requests matching the provided url. The handler is a function taking a [Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/) input that provides functions to continue, fulfill or abort the request. Once routing is enabled, every request matching the url pattern will stall unless one of these functions is called.
+The method adds a route that allows modifying network requests matching the provided url. The handler is a function taking a [Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/) input that provides functions to [continue](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/continue), [fulfill](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/fulfill) or [abort](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/abort) the request. Once routing is enabled, every request matching the url pattern will stall unless one of these functions is called.
 
 When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones.
 
-| Parameter | Type   | Default | Description                                   |
-| --------- | ------ | ------- | --------------------------------------------- |
-| url  | string or Regexp | `''`    | URL to match during routing. |
-| handler  | function([Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/)) | null    | Handler function executed when routing the request. |
+| Parameter | Type                                                                                         | Default | Description                                         |
+| --------- | -------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------- |
+| url       | string or Regexp                                                                             | `''`    | URL to match during routing.                        |
+| handler   | function([Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/)) | null    | Handler function executed when routing the request. |
 
 ### Returns
 
-| Type            | Description                                                                     |
-| --------------- | ------------------------------------------------------------------------------- |
-| `Promise<void>` | A Promise that fulfills when the route is added to the page.                    |
-
+| Type            | Description                                                  |
+| --------------- | ------------------------------------------------------------ |
+| `Promise<void>` | A Promise that fulfills when the route is added to the page. |
 
 ### Example
 
@@ -47,9 +46,43 @@ export default async function () {
   // Abort all images requests
   await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
     await route.abort();
-  })
+  });
+
+  // Fulfill request with the following response which
+  // changes the quotes displayed on the page
+  await page.route(/.*\/quotes$/, async function (route) {
+    await route.fulfill({
+      body: JSON.stringify({
+        quotes: ['"We ❤️ pizza" - k6 team'],
+      }),
+    });
+  });
+
+  // Change the pizza request when the button is clicked
+  await page.route(/.*\/pizza$/, async function (route) {
+    await route.continue({
+      headers: {
+        ...route.request().headers(),
+        foo: 'bar',
+      },
+      method: 'POST',
+      postData: JSON.stringify({
+        maxCaloriesPerSlice: 500,
+        mustBeVegetarian: true,
+        excludedIngredients: ['Pineapple'],
+        excludedTools: ['Knife', 'Scissors'],
+        maxNumberOfToppings: 1,
+        minNumberOfToppings: 1,
+        customName: 'Classic Pizza',
+      }),
+    });
+  });
 
   await page.goto('https://quickpizza.grafana.com/');
+
+  await page.getByRole('button', { name: 'Pizza, Please!' }).click();
+
+  await page.close();
 }
 ```
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
index 1d91613c5d..75ae081aa6 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
@@ -12,12 +12,12 @@ When several routes match the given pattern, they run in the order opposite to t
 
 ## Supported APIs
 
-| Method                                                                                                                             | Description                                                                                                                                             |
-| ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [abort([errorCode])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/abort) | Aborts the route's request.                                                         |
-| [continue([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/continue) | Continues the request with optional overrides.                                                       |
-| [fulfill([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/fulfill) | Fulfills the request with the given response |
-| [request()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/request) | Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request) object.                       |
+| Method                                                                                                   | Description                                                                                                        |
+| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| [abort([errorCode])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/abort)     | Aborts the route's request.                                                                                        |
+| [continue([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/continue) | Continues the request with optional overrides.                                                                     |
+| [fulfill([options])](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/fulfill)   | Fulfills the request with the given response                                                                       |
+| [request()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/request)            | Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request) object. |
 
 ### Example
 
@@ -45,9 +45,44 @@ export default async function () {
   // Abort all images requests
   await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
     await route.abort();
-  })
+  });
+
+  // Fulfill request with the following response which
+  // changes the quotes displayed on the page
+  await page.route(/.*\/quotes$/, async function (route) {
+    await route.fulfill({
+      body: JSON.stringify({
+        quotes: ['"We ❤️ pizza" - k6 team'],
+      }),
+    });
+  });
+
+  // Change the pizza request when the button is clicked
+  await page.route(/.*\/pizza$/, async function (route) {
+    await route.continue({
+      headers: {
+        ...route.request().headers(),
+        foo: 'bar',
+      },
+      method: 'POST',
+      postData: JSON.stringify({
+        maxCaloriesPerSlice: 500,
+        mustBeVegetarian: true,
+        excludedIngredients: ['Pineapple'],
+        excludedTools: ['Knife', 'Scissors'],
+        maxNumberOfToppings: 1,
+        minNumberOfToppings: 1,
+        customName: 'Classic Pizza',
+      }),
+    });
+  });
 
   await page.goto('https://quickpizza.grafana.com/');
+
+  await page.getByRole('button', { name: 'Pizza, Please!' }).click();
+
+  await page.close();
+}
 ```
 
 {{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
index 24f528d82d..f8ba940359 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
@@ -1,21 +1,21 @@
 ---
-title: 'abort(errorCode)'
+title: 'abort([errorCode])'
 description: 'Browser module: Route.abort method'
 ---
 
-# abort(errorCode)
+# abort([errorCode])
 
 Aborts the request with the given error code.
 
-| Parameter           | Type             | Default    | Description                                                          |
-| ------------------- | ---------------- | ---------- | -------------------------------------------------------------------- |
-| errorCode           | string           | `'failed'` | Error code when aborting the request. Can be one of the following: `'aborted'`, `'accessdenied'`, `'addressunreachable'`, `'blockedbyclient'`, `'blockedbyresponse'`, `'connectionaborted'`,`'connectionclosed'`, `'connectionfailed'`, `'connectionrefused'`, `'connectionreset'`, `'internetdisconnected'`, `'namenotresolved'`, `'timedout'`, `'failed'`.                                                       |
+| Parameter | Type   | Default    | Description                                                                                                                                                                                                                                                                                                                                                  |
+| --------- | ------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| errorCode | string | `'failed'` | Error code when aborting the request. Can be one of the following: `'aborted'`, `'accessdenied'`, `'addressunreachable'`, `'blockedbyclient'`, `'blockedbyresponse'`, `'connectionaborted'`,`'connectionclosed'`, `'connectionfailed'`, `'connectionrefused'`, `'connectionreset'`, `'internetdisconnected'`, `'namenotresolved'`, `'timedout'`, `'failed'`. |
 
 ### Returns
 
-| Type            | Description                                                                     |
-| --------------- | ------------------------------------------------------------------------------- |
-| `Promise<void>` | A Promise that fulfills when the request is aborted.                            |
+| Type            | Description                                          |
+| --------------- | ---------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the request is aborted. |
 
 ### Example
 
@@ -42,10 +42,13 @@ export default async function () {
 
   // Abort all images requests
   await page.route(/(\.png$)|(\.jpg$)/, async function (route) {
-    await route.abort();
-  })
+    await route.abort('blockedbyclient');
+  });
 
   await page.goto('https://quickpizza.grafana.com/');
+
+  await page.close();
+}
 ```
 
 {{< /code >}}
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
index 7be04a5645..bb74c1fa14 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
@@ -1,25 +1,31 @@
 ---
-title: 'continue(options)'
+title: 'continue([options])'
 description: 'Browser module: Route.continue method'
 ---
 
-# continue(options)
+# continue([options])
+
+{{< admonition type="caution" >}}
+
+This method has **known issues**, but it does work as intended. For details, refer to [#5012](https://github.com/grafana/k6/issues/5012).
+
+{{< /admonition >}}
 
 Sends the request to the network with optional overrides.
 
-| Parameter           | Type             | Default | Description                                                          |
-| ------------------- | ---------------- | ------- | -------------------------------------------------------------------- |
-| options             | object           | null    |                                                                      |
-| options.headers     | object           | null    | Request headers.                                                     |
-| options.method      | string           | `''`    | Request method (e.g. GET or POST).                                   |
-| options.postData    | string or Buffer | `''`    | Post data of the request.                                            |
-| options.url         | string           | `''`    | Request URL.                                                         |
+| Parameter        | Type             | Default | Description                        |
+| ---------------- | ---------------- | ------- | ---------------------------------- |
+| options          | object           | null    |                                    |
+| options.headers  | object           | null    | Request headers.                   |
+| options.method   | string           | `''`    | Request method (e.g. GET or POST). |
+| options.postData | string or Buffer | `''`    | Post data of the request.          |
+| options.url      | string           | `''`    | Request URL.                       |
 
 ### Returns
 
-| Type            | Description                                                                     |
-| --------------- | ------------------------------------------------------------------------------- |
-| `Promise<void>` | A Promise that fulfills when the request is resumed.                            |
+| Type            | Description                                          |
+| --------------- | ---------------------------------------------------- |
+| `Promise<void>` | A Promise that fulfills when the request is resumed. |
 
 ### Example
 
@@ -30,7 +36,7 @@ import { browser } from 'k6/browser';
 
 export const options = {
   scenarios: {
-    ui: {
+    browser: {
       executor: 'shared-iterations',
       options: {
         browser: {
@@ -44,19 +50,31 @@ export const options = {
 export default async function () {
   const page = await browser.newPage();
 
-  try {
-    await page.route(/.*\/api\/pizza/, async function (route) {
-      await route.continue({
-        postData: JSON.stringify({
-          customName: 'My Pizza',
-        }),
-      });
+  // Change the pizza request when the button is clicked
+  await page.route(/.*\/pizza$/, async function (route) {
+    await route.continue({
+      headers: {
+        ...route.request().headers(),
+        foo: 'bar',
+      },
+      method: 'POST',
+      postData: JSON.stringify({
+        maxCaloriesPerSlice: 500,
+        mustBeVegetarian: true,
+        excludedIngredients: ['Pineapple'],
+        excludedTools: ['Knife', 'Scissors'],
+        maxNumberOfToppings: 1,
+        minNumberOfToppings: 1,
+        customName: 'Classic Pizza',
+      }),
     });
+  });
+
+  await page.goto('https://quickpizza.grafana.com/');
+
+  await page.getByRole('button', { name: 'Pizza, Please!' }).click();
 
-    await page.goto('https://quickpizza.grafana.com/');
-  } finally {
-    await page.close();
-  }
+  await page.close();
 }
 ```
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
index ab43eedcba..c2bac12664 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
@@ -5,22 +5,27 @@ description: 'Browser module: Route.fulfill method'
 
 # fulfill(options)
 
+{{< admonition type="caution" >}}
+
+This method has **known issues**, but it does work as intended. For details, refer to [#5012](https://github.com/grafana/k6/issues/5012).
+
+{{< /admonition >}}
+
 Fulfills the request with the given response.
 
-| Parameter           | Type             | Default | Description                                                          |
-| ------------------- | ---------------- | ------- | -------------------------------------------------------------------- |
-| options             | object           | null    |                                                                      |
-| options.body        | string or Buffer | `''`    | Response body.                                                       |
-| options.contentType | string           | `''`    | Same as setting `Content-Type` response header.                      |
-| options.headers     | object           | null    | Response headers.                                                    |
-| options.status      | number           | `200`   | Response status code.                                                |
+| Parameter           | Type             | Default | Description                                     |
+| ------------------- | ---------------- | ------- | ----------------------------------------------- |
+| options             | object           | null    |                                                 |
+| options.body        | string or Buffer | `''`    | Response body.                                  |
+| options.contentType | string           | `''`    | Same as setting `Content-Type` response header. |
+| options.headers     | object           | null    | Response headers.                               |
+| options.status      | number           | `200`   | Response status code.                           |
 
 ### Returns
 
-| Type            | Description                                                                     |
-| --------------- | ------------------------------------------------------------------------------- |
-| `Promise<void>` | A Promise that fulfills when the request is fulfilled.                          |
-
+| Type            | Description                                            |
+| --------------- | ------------------------------------------------------ |
+| `Promise<void>` | A Promise that fulfills when the request is fulfilled. |
 
 ### Example
 
@@ -31,7 +36,7 @@ import { browser } from 'k6/browser';
 
 export const options = {
   scenarios: {
-    ui: {
+    browser: {
       executor: 'shared-iterations',
       options: {
         browser: {
@@ -46,24 +51,21 @@ export default async function () {
   const page = await browser.newPage();
 
   try {
-    await page.route(
-      "https://jsonplaceholder.typicode.com/todos/1",
-      async function (route) {
-        await route.fulfill({
-          status: 200,
-          body: JSON.stringify({
-            "id": 1,
-            "title": "Test Todo",
-            "completed": false
-          }),
-          contentType: "application/json",
-          headers: {
-            "Access-Control-Allow-Origin": "*",
-            "Access-Control-Allow-Credentials": "true",
-          },
-        });
-      }
-    );
+    await page.route('https://jsonplaceholder.typicode.com/todos/1', async function (route) {
+      await route.fulfill({
+        status: 200,
+        body: JSON.stringify({
+          id: 1,
+          title: 'Test Todo',
+          completed: false,
+        }),
+        contentType: 'application/json',
+        headers: {
+          'Access-Control-Allow-Origin': '*',
+          'Access-Control-Allow-Credentials': 'true',
+        },
+      });
+    });
 
     await page.goto('https://quickpizza.grafana.com/browser.php');
   } finally {

From 0b29d771dae32e280d210ab0eaeb75206a64aced Mon Sep 17 00:00:00 2001
From: ankur22 <ankur.agarwal@grafana.com>
Date: Fri, 8 Aug 2025 17:06:43 +0100
Subject: [PATCH 3/5] Add skip on examples for now

---
 .../javascript-api/k6-browser/page/route.md   |  2 ++
 .../javascript-api/k6-browser/route/_index.md |  2 ++
 .../javascript-api/k6-browser/route/abort.md  |  2 ++
 .../k6-browser/route/continue.md              |  2 ++
 .../k6-browser/route/fulfill.md               |  2 ++
 .../k6-browser/route/request.md               | 22 +++++++++----------
 6 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
index 53f5342c4b..6de9a73073 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
@@ -24,6 +24,8 @@ When several routes match the given pattern, they run in the order opposite to t
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
index 75ae081aa6..f6a23e2681 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
@@ -23,6 +23,8 @@ When several routes match the given pattern, they run in the order opposite to t
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
index f8ba940359..e8f5ac5289 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
@@ -21,6 +21,8 @@ Aborts the request with the given error code.
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
index bb74c1fa14..67be53ee8b 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
@@ -31,6 +31,8 @@ Sends the request to the network with optional overrides.
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
index c2bac12664..08b0d1e7c3 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
@@ -31,6 +31,8 @@ Fulfills the request with the given response.
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/request.md b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
index 67317298af..951b03898d 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
@@ -17,6 +17,8 @@ Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascri
 
 {{< code >}}
 
+<!-- md-k6:skip -->
+
 ```javascript
 import { browser } from 'k6/browser';
 
@@ -38,17 +40,15 @@ export default async function () {
 
   try {
     await page.route(/.*\/api\/pizza/, async function (route) {
-      await route.continue(
-        {
-          headers: {
-            ...route.request().headers(),
-            'Content-Type': 'application/json',
-          },
-          postData: JSON.stringify({
-              'customName': 'My Pizza'
-          }),
-        }
-      );
+      await route.continue({
+        headers: {
+          ...route.request().headers(),
+          'Content-Type': 'application/json',
+        },
+        postData: JSON.stringify({
+          customName: 'My Pizza',
+        }),
+      });
     });
 
     await page.goto('https://quickpizza.grafana.com/');

From 4ebc2c8bb83d338f9334cdd06c0d6334c8b43035 Mon Sep 17 00:00:00 2001
From: ankur22 <ankur.agarwal@grafana.com>
Date: Mon, 11 Aug 2025 08:57:17 +0100
Subject: [PATCH 4/5] Update subheading to h2 from h3

---
 docs/sources/k6/next/javascript-api/k6-browser/page/route.md  | 4 ++--
 docs/sources/k6/next/javascript-api/k6-browser/route/abort.md | 4 ++--
 .../k6/next/javascript-api/k6-browser/route/continue.md       | 4 ++--
 .../k6/next/javascript-api/k6-browser/route/fulfill.md        | 4 ++--
 .../k6/next/javascript-api/k6-browser/route/request.md        | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
index 6de9a73073..5262d8e619 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
@@ -14,13 +14,13 @@ When several routes match the given pattern, they run in the order opposite to t
 | url       | string or Regexp                                                                             | `''`    | URL to match during routing.                        |
 | handler   | function([Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/)) | null    | Handler function executed when routing the request. |
 
-### Returns
+## Returns
 
 | Type            | Description                                                  |
 | --------------- | ------------------------------------------------------------ |
 | `Promise<void>` | A Promise that fulfills when the route is added to the page. |
 
-### Example
+## Example
 
 {{< code >}}
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
index e8f5ac5289..75aa5e8387 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/abort.md
@@ -11,13 +11,13 @@ Aborts the request with the given error code.
 | --------- | ------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | errorCode | string | `'failed'` | Error code when aborting the request. Can be one of the following: `'aborted'`, `'accessdenied'`, `'addressunreachable'`, `'blockedbyclient'`, `'blockedbyresponse'`, `'connectionaborted'`,`'connectionclosed'`, `'connectionfailed'`, `'connectionrefused'`, `'connectionreset'`, `'internetdisconnected'`, `'namenotresolved'`, `'timedout'`, `'failed'`. |
 
-### Returns
+## Returns
 
 | Type            | Description                                          |
 | --------------- | ---------------------------------------------------- |
 | `Promise<void>` | A Promise that fulfills when the request is aborted. |
 
-### Example
+## Example
 
 {{< code >}}
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
index 67be53ee8b..9f775297fa 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/continue.md
@@ -21,13 +21,13 @@ Sends the request to the network with optional overrides.
 | options.postData | string or Buffer | `''`    | Post data of the request.          |
 | options.url      | string           | `''`    | Request URL.                       |
 
-### Returns
+## Returns
 
 | Type            | Description                                          |
 | --------------- | ---------------------------------------------------- |
 | `Promise<void>` | A Promise that fulfills when the request is resumed. |
 
-### Example
+## Example
 
 {{< code >}}
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
index 08b0d1e7c3..6ad47bdc74 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/fulfill.md
@@ -21,13 +21,13 @@ Fulfills the request with the given response.
 | options.headers     | object           | null    | Response headers.                               |
 | options.status      | number           | `200`   | Response status code.                           |
 
-### Returns
+## Returns
 
 | Type            | Description                                            |
 | --------------- | ------------------------------------------------------ |
 | `Promise<void>` | A Promise that fulfills when the request is fulfilled. |
 
-### Example
+## Example
 
 {{< code >}}
 
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/request.md b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
index 951b03898d..affc14b422 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/request.md
@@ -7,13 +7,13 @@ description: 'Browser module: Route.request method'
 
 Returns the matching [Request](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request) object.
 
-### Returns
+## Returns
 
 | Type      | Description           |
 | --------- | --------------------- |
 | `Request` | The `Request` object. |
 
-### Example
+## Example
 
 {{< code >}}
 

From 3d05d5b948969efd7e917da68abdb1f159ad7b3a Mon Sep 17 00:00:00 2001
From: ankur22 <ankur.agarwal@grafana.com>
Date: Tue, 12 Aug 2025 10:28:12 +0100
Subject: [PATCH 5/5] Update wording around matching handlers

---
 docs/sources/k6/next/javascript-api/k6-browser/page/route.md   | 2 +-
 docs/sources/k6/next/javascript-api/k6-browser/route/_index.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
index 5262d8e619..dc7f16ab02 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/page/route.md
@@ -7,7 +7,7 @@ description: 'Browser module: page.route(url, handler) method'
 
 The method adds a route that allows modifying network requests matching the provided url. The handler is a function taking a [Route](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/) input that provides functions to [continue](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/continue), [fulfill](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/fulfill) or [abort](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/route/abort) the request. Once routing is enabled, every request matching the url pattern will stall unless one of these functions is called.
 
-When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones.
+When several routes match the given pattern, only the last registered route handler will run, and all others will be skipped.
 
 | Parameter | Type                                                                                         | Default | Description                                         |
 | --------- | -------------------------------------------------------------------------------------------- | ------- | --------------------------------------------------- |
diff --git a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
index f6a23e2681..1b09f05e8a 100644
--- a/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
+++ b/docs/sources/k6/next/javascript-api/k6-browser/route/_index.md
@@ -8,7 +8,7 @@ weight: 12
 
 Route represents a network request intercepted by the [`page.route()`](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/page/route) function and allows to modify its behavior. Once routing is enabled, every request intercepted by a route will stall unless it's continued, fulfilled or aborted.
 
-When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones.
+When several routes match the given pattern, only the last registered route handler will run, and all others will be skipped.
 
 ## Supported APIs