Update Browser API migration to async note (#1638)

* Update Browser API migration to async note

* Style fix

---------

Co-authored-by: Heitor Tashiro Sergent <[email protected]>

Author: andrewslotin

docs/sources/next/using-k6-browser/running-browser-tests.md

@@ -70,7 +70,7 @@ To run a simple local script:
 
    {{% admonition type="note" %}}
 
-   To provide rough compatibility with the Playwright API, the browser module API is also being converted from synchronous to asynchronous. `page.goto()` is now asynchronous so `await` keyword is used to deal with the asynchronous nature of the operation.
+   Starting from v0.52.0 the browser module API has been converted to an asynchronous API. That means that most of the methods now return promises. Refer to the [migration guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser/migrating-to-k6-v0-52/) to learn more about the changes and how to update your scripts.
 
    {{% /admonition %}}
 
@@ -257,21 +257,18 @@ export default async function () {
   const page = await browser.newPage();
 
   try {
-    await page.goto("https://test.k6.io/my_messages.php");
+    await page.goto('https://test.k6.io/my_messages.php');
 
-    await page.locator('input[name="login"]').type("admin");
-    await page.locator('input[name="password"]').type("123");
+    await page.locator('input[name="login"]').type('admin');
+    await page.locator('input[name="password"]').type('123');
 
     const submitButton = page.locator('input[type="submit"]');
 
-    await Promise.all([
-      page.waitForNavigation(),
-      submitButton.click(),
-    ]);
+    await Promise.all([page.waitForNavigation(), submitButton.click()]);
 
-    const header = await page.locator("h2").textContent();
+    const header = await page.locator('h2').textContent();
     check(header, {
-      header: h => h == "Welcome, admin!",
+      header: (h) => h == 'Welcome, admin!',
     });
   } finally {
     await page.close();
@@ -340,7 +337,7 @@ export async function browserTest() {
 
     const info = await page.locator('#counter-button').textContent();
     check(info, {
-      'checkbox is checked': info => info === 'Thanks for checking the box',
+      'checkbox is checked': (info) => info === 'Thanks for checking the box',
     });
   } finally {
     await page.close();

docs/sources/v0.52.x/using-k6-browser/running-browser-tests.md

@@ -70,7 +70,7 @@ To run a simple local script:
 
    {{% admonition type="note" %}}
 
-   To provide rough compatibility with the Playwright API, the browser module API is also being converted from synchronous to asynchronous. `page.goto()` is now asynchronous so `await` keyword is used to deal with the asynchronous nature of the operation.
+   Starting from v0.52.0 the browser module API has been converted to an asynchronous API. That means that most of the methods now return promises. Refer to the [migration guide](https://grafana.com/docs/k6/<K6_VERSION>/using-k6-browser/migrating-to-k6-v0-52/) to learn more about the changes and how to update your scripts.
 
    {{% /admonition %}}
 
@@ -257,21 +257,18 @@ export default async function () {
   const page = await browser.newPage();
 
   try {
-    await page.goto("https://test.k6.io/my_messages.php");
+    await page.goto('https://test.k6.io/my_messages.php');
 
-    await page.locator('input[name="login"]').type("admin");
-    await page.locator('input[name="password"]').type("123");
+    await page.locator('input[name="login"]').type('admin');
+    await page.locator('input[name="password"]').type('123');
 
     const submitButton = page.locator('input[type="submit"]');
 
-    await Promise.all([
-      page.waitForNavigation(),
-      submitButton.click(),
-    ]);
+    await Promise.all([page.waitForNavigation(), submitButton.click()]);
 
-    const header = await page.locator("h2").textContent();
+    const header = await page.locator('h2').textContent();
     check(header, {
-      header: h => h == "Welcome, admin!",
+      header: (h) => h == 'Welcome, admin!',
     });
   } finally {
     await page.close();
@@ -340,7 +337,7 @@ export async function browserTest() {
 
     const info = await page.locator('#counter-button').textContent();
     check(info, {
-      'checkbox is checked': info => info === 'Thanks for checking the box',
+      'checkbox is checked': (info) => info === 'Thanks for checking the box',
     });
   } finally {
     await page.close();