Update mentions of Playwright (#2051)

* Update mentions of Playwright

* Playwright methods

* Add skip code blocks

* Ankur's feedback

* Apply to v1.2.x

Author: heitortsergent

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

@@ -8,11 +8,9 @@ weight: 02
 
 # browser
 
-The browser module APIs aim for rough compatibility with the [Playwright API for NodeJS](https://playwright.dev/docs/api/class-playwright).
+The browser module APIs are inspired by Playwright and other frontend testing frameworks.
 
-Note that because k6 does not run in NodeJS, the browser module APIs will slightly differ from their Playwright counterparts.
-
-You can find examples of using [the browser module API](#browser-module-api) in our [getting started guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser).
+You can find examples of using [the browser module API](#browser-module-api) in the [getting started guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser).
 
 {{< admonition type="note" >}}
 

docs/sources/k6/next/javascript-api/k6-browser/console-message.md

@@ -1,6 +1,5 @@
 ---
 title: 'ConsoleMessage'
-slug: 'consolemessage'
 description: 'Browser module: ConsoleMessage Class'
 weight: 03
 ---
@@ -11,9 +10,9 @@ weight: 03
 
 ## Supported APIs
 
-| Method                                                                                                          | Playwright Relevant Distinctions |
-| --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-args" target="_blank" >args()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-page" target="_blank" >page()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-text" target="_blank" >text()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-type" target="_blank" >type()</a> | -                                |
+| Method | Description                                                      |
+| ------ | ---------------------------------------------------------------- |
+| args() | List of arguments passed to a `console` function call.           |
+| page() | The page that produced this console message.                     |
+| text() | The text of the console message.                                 |
+| type() | The type of the console message. For example: `log`, or `debug`. |

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

@@ -12,7 +12,7 @@ The request that the browser performs can be retrieved from the [Response](https
 
 ## Supported APIs
 
-| Method                                                                                                                            | Playwright Relevant Distinctions                                                                                     |
+| Method                                                                                                                            | Description                                                                                                          |
 | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
 | [allHeaders()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/allheaders) {{< docs/bwipt id="965" >}} | Returns an object of headers associated to the request including headers added by the browser.                       |
 | [frame()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/frame)                                       | The [Frame](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/frame/) that initiated the request.   |
@@ -25,7 +25,7 @@ The request that the browser performs can be retrieved from the [Response](https
 | [postDataBuffer()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/postdatabuffer)                     | Request's post body in a binary form, if any.                                                                        |
 | [resourceType()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/resourcetype)                         | Contains the request's resource type as it was perceived by the rendering engine.                                    |
 | [response()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/response)                                 | Returns the matching [Response](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/response) object. |
-| [size()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/size)                                         | Unlike Playwright, this method returns an object containing the sizes of request headers and body.                   |
+| [size()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/size)                                         | Returns an object containing the size of the request headers and body.                   |
 | [timing()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/timing)                                     | Returns resource timing information for given request.                                                               |
 | [url()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/url)                                           | URL of the request.                                                                                                  |
 

docs/sources/k6/next/shared/javascript-api/jslib.md

@@ -11,5 +11,5 @@ title: javascript-api/jslib
 | [k6chaijs](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/k6chaijs)                                             | BDD assertion style                                                                                                    |
 | [http-instrumentation-pyroscope](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/http-instrumentation-pyroscope) | Library to instrument k6/http to send baggage headers for pyroscope to read back                                       |
 | [http-instrumentation-tempo](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/http-instrumentation-tempo)         | Library to instrument k6/http to send tracing data                                                                     |
-| [testing](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing)                                               | Advanced assertion library with Playwright-compatible API for protocol and browser testing                             |
+| [testing](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/testing)                                               | Advanced assertion library with Playwright-inspired API for protocol and browser testing                             |
 | [utils](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/jslib/utils)                                                   | Small utility functions useful in every day load testing                                                               |

docs/sources/k6/next/using-k6-browser/_index.md

@@ -10,8 +10,6 @@ weight: 300
 
 The browser module brings browser automation and end-to-end web testing to k6 while supporting core k6 features. It adds browser-level APIs to interact with browsers and collect frontend performance metrics as part of your k6 tests.
 
-This module aims to provide rough compatibility with the Playwright API, so you don’t need to learn a completely new API.
-
 {{< admonition type="note" >}}
 
 To work with the browser module, make sure you are using the latest [k6 version](https://github.com/grafana/k6/releases), and install a Chromium-based browser on your machine (such as [Google Chrome](https://www.google.com/chrome/)).

docs/sources/k6/next/using-k6-browser/how-to-write-browser-tests/asynchronous-operations.md

@@ -116,7 +116,7 @@ This avoids the use of `Promise.all` which can be confusing to work with, and in
 The browser module uses asynchronous APIs that require `await` for several reasons:
 
 1. JavaScript is single-threaded with a single event loop. Asynchronous APIs prevent blocking the thread and event loop with long-running or I/O-based tasks.
-1. Consistency with [Playwright](https://playwright.dev/), a popular browser automation library.
+1. Consistency with [Playwright](https://playwright.dev/) and other frontend testing frameworks.
 1. Alignment with how developers expect to work with modern JavaScript APIs.
 
 For example:

docs/sources/k6/next/using-k6-browser/recommended-practices/page-object-model-pattern.md

@@ -8,11 +8,11 @@ weight: 02
 
 # Page object model
 
-When working with large test suites, a popular design pattern to improve your code’s maintainability and readability is the [page object model](https://martinfowler.com/bliki/PageObject.html).
+When working with large test suites, a popular design pattern to improve your code's maintainability and readability is the [page object model](https://martinfowler.com/bliki/PageObject.html).
 
-A page object commonly represents an HTML page or significant elements/components within a page, such as a header or a footer. It is a form of encapsulation that hides the details of the UI structure from other places, such as your test files. Through page object models, any changes you need to make on a specific page or element within a page are constrained into a single place, resulting in ease of maintenance and avoiding code duplication.
+A page object commonly represents an HTML page or significant elements/components within a page, such as a header or a footer. It's a form of encapsulation that hides the details of the UI structure from other places, such as your test files. Through page object models, any changes you need to make on a specific page or element within a page are constrained into a single place, resulting in ease of maintenance and avoiding code duplication.
 
-Since k6 browser aims to provide rough compatibility with the Playwright API, you can leverage any existing page objects you have and easily re-use them with your k6 browser tests.
+Since k6 browser is inspired by Playwright, you can leverage any existing page objects you have and re-use them with your k6 browser tests.
 
 ## Implementation
 
@@ -28,7 +28,7 @@ The `homepage.js` class also contains different methods for:
 
 When locators need to be updated or other specific changes related to the homepage are made, you only need to update the `homepage.js` class.
 
-{{< code >}}
+<!-- md-k6:skip -->
 
 ```javascript
 import { bookingData } from '../data/booking-data.js';
@@ -66,11 +66,9 @@ export class Homepage {
 }
 ```
 
-{{< /code >}}
-
 You can import the `Homepage` class within your test class and invoke the methods you need. This makes the code easier to understand and enforces the separation between your test and business logic.
 
-{{< code >}}
+<!-- md-k6:skip -->
 
 ```javascript
 import { browser } from 'k6/browser';
@@ -93,5 +91,3 @@ export default async function () {
   await page.close();
 }
 ```
-
-{{< /code >}}

docs/sources/k6/v1.2.x/javascript-api/k6-browser/_index.md

@@ -8,11 +8,9 @@ weight: 02
 
 # browser
 
-The browser module APIs aim for rough compatibility with the [Playwright API for NodeJS](https://playwright.dev/docs/api/class-playwright).
+The browser module APIs are inspired by Playwright and other frontend testing frameworks.
 
-Note that because k6 does not run in NodeJS, the browser module APIs will slightly differ from their Playwright counterparts.
-
-You can find examples of using [the browser module API](#browser-module-api) in our [getting started guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser).
+You can find examples of using [the browser module API](#browser-module-api) in the [getting started guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser).
 
 {{< admonition type="note" >}}
 

docs/sources/k6/v1.2.x/javascript-api/k6-browser/console-message.md

@@ -1,6 +1,5 @@
 ---
 title: 'ConsoleMessage'
-slug: 'consolemessage'
 description: 'Browser module: ConsoleMessage Class'
 weight: 03
 ---
@@ -11,9 +10,9 @@ weight: 03
 
 ## Supported APIs
 
-| Method                                                                                                          | Playwright Relevant Distinctions |
-| --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-args" target="_blank" >args()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-page" target="_blank" >page()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-text" target="_blank" >text()</a> | -                                |
-| <a href="https://playwright.dev/docs/api/class-consolemessage#console-message-type" target="_blank" >type()</a> | -                                |
+| Method | Description                                                      |
+| ------ | ---------------------------------------------------------------- |
+| args() | List of arguments passed to a `console` function call.           |
+| page() | The page that produced this console message.                     |
+| text() | The text of the console message.                                 |
+| type() | The type of the console message. For example: `log`, or `debug`. |

docs/sources/k6/v1.2.x/javascript-api/k6-browser/request/_index.md

@@ -12,7 +12,7 @@ The request that the browser performs can be retrieved from the [Response](https
 
 ## Supported APIs
 
-| Method                                                                                                                            | Playwright Relevant Distinctions                                                                                     |
+| Method                                                                                                                            | Description                                                                                                          |
 | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
 | [allHeaders()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/allheaders) {{< docs/bwipt id="965" >}} | Returns an object of headers associated to the request including headers added by the browser.                       |
 | [frame()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/frame)                                       | The [Frame](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/frame/) that initiated the request.   |
@@ -25,7 +25,7 @@ The request that the browser performs can be retrieved from the [Response](https
 | [postDataBuffer()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/postdatabuffer)                     | Request's post body in a binary form, if any.                                                                        |
 | [resourceType()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/resourcetype)                         | Contains the request's resource type as it was perceived by the rendering engine.                                    |
 | [response()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/response)                                 | Returns the matching [Response](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/response) object. |
-| [size()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/size)                                         | Unlike Playwright, this method returns an object containing the sizes of request headers and body.                   |
+| [size()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/size)                                         | Returns an object containing the size of the request headers and body.                   |
 | [timing()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/timing)                                     | Returns resource timing information for given request.                                                               |
 | [url()](https://grafana.com/docs/k6/<K6_VERSION>/javascript-api/k6-browser/request/url)                                           | URL of the request.                                                                                                  |