This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

JavaScript API

k6/browser

JSHandle

evaluateHandle(pageFunction[, arg])

Open source

evaluateHandle(pageFunction[, arg])

Executes JavaScript code in the page, passing this handle as the first argument to the pageFunction and arg as the following arguments. It returns the value of the pageFunction invocation as a JSHandle.

The only difference between evaluate and evaluateHandle is that evaluateHandle returns JSHandle.

Parameter	Type	Defaults	Description
pageFunction	function or string		Function to be evaluated in the page context.
arg	string	`''`	Optional argument to pass to `pageFunction`.

Returns

Type	Description
Promise	A `JSHandle` of the return value of `pageFunction`.

Example

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();

  try {
    await page.goto('https://test.k6.io/browser.php');
    const jsHandle = await page.evaluateHandle(() => document.body);

    const obj = await jsHandle.evaluateHandle((handle) => {
      return { innerText: handle.innerText };
    });
    console.log(await obj.jsonValue()); // {"innerText":"< Back...
  } finally {
    await page.close();
  }
}