Running browser tests with async check

Author: inancgumus

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

@@ -228,8 +228,8 @@ To avoid timing errors or other race conditions in your script, if you have acti
 {{< code >}}
 
 ```javascript
-import { check } from 'k6';
 import { browser } from 'k6/browser';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 
 export const options = {
   scenarios: {
@@ -258,11 +258,13 @@ export default async function () {
 
     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();
-    check(header, {
-      header: (h) => h == 'Welcome, admin!',
+    await check(page.locator('h2'), {
+      'header': async lo => await lo.textContent() == 'Welcome, admin!'
     });
   } finally {
     await page.close();
@@ -296,7 +298,7 @@ Keep in mind that there is an additional performance overhead when it comes to s
 
 ```javascript
 import { browser } from 'k6/browser';
-import { check } from 'k6';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 import http from 'k6/http';
 
 export const options = {
@@ -329,9 +331,9 @@ export async function browserTest() {
 
     await page.locator('#checkbox1').check();
 
-    const info = await page.locator('#checkbox-info-display').textContent();
-    check(info, {
-      'checkbox is checked': (info) => info === 'Thanks for checking the box',
+    await check(page.locator('#checkbox-info-display'), {
+      'checkbox is checked': async lo =>
+        await lo.textContent() === 'Thanks for checking the box'
     });
   } finally {
     await page.close();

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

@@ -228,8 +228,8 @@ To avoid timing errors or other race conditions in your script, if you have acti
 {{< code >}}
 
 ```javascript
-import { check } from 'k6';
 import { browser } from 'k6/browser';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 
 export const options = {
   scenarios: {
@@ -258,11 +258,13 @@ export default async function () {
 
     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();
-    check(header, {
-      header: (h) => h == 'Welcome, admin!',
+    await check(page.locator('h2'), {
+      'header': async lo => await lo.textContent() == 'Welcome, admin!'
     });
   } finally {
     await page.close();
@@ -296,7 +298,7 @@ Keep in mind that there is an additional performance overhead when it comes to s
 
 ```javascript
 import { browser } from 'k6/browser';
-import { check } from 'k6';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 import http from 'k6/http';
 
 export const options = {
@@ -329,9 +331,9 @@ export async function browserTest() {
 
     await page.locator('#checkbox1').check();
 
-    const info = await page.locator('#checkbox-info-display').textContent();
-    check(info, {
-      'checkbox is checked': (info) => info === 'Thanks for checking the box',
+    await check(page.locator('#checkbox-info-display'), {
+      'checkbox is checked': async lo =>
+        await lo.textContent() === 'Thanks for checking the box'
     });
   } finally {
     await page.close();

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

@@ -228,8 +228,8 @@ To avoid timing errors or other race conditions in your script, if you have acti
 {{< code >}}
 
 ```javascript
-import { check } from 'k6';
 import { browser } from 'k6/browser';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 
 export const options = {
   scenarios: {
@@ -258,11 +258,13 @@ export default async function () {
 
     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();
-    check(header, {
-      header: (h) => h == 'Welcome, admin!',
+    await check(page.locator('h2'), {
+      'header': async lo => await lo.textContent() == 'Welcome, admin!'
     });
   } finally {
     await page.close();
@@ -296,7 +298,7 @@ Keep in mind that there is an additional performance overhead when it comes to s
 
 ```javascript
 import { browser } from 'k6/browser';
-import { check } from 'k6';
+import { check } from 'https://jslib.k6.io/k6-utils/1.5.0/index.js';
 import http from 'k6/http';
 
 export const options = {
@@ -329,9 +331,9 @@ export async function browserTest() {
 
     await page.locator('#checkbox1').check();
 
-    const info = await page.locator('#checkbox-info-display').textContent();
-    check(info, {
-      'checkbox is checked': (info) => info === 'Thanks for checking the box',
+    await check(page.locator('#checkbox-info-display'), {
+      'checkbox is checked': async lo =>
+        await lo.textContent() === 'Thanks for checking the box'
     });
   } finally {
     await page.close();