Open source

evaluate(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.

ParameterTypeDefaultsDescription
pageFunctionfunction or stringFunction to be evaluated in the page context.
argstring''Optional argument to pass to pageFunction.

Returns

TypeDescription
PromiseThe return value of pageFunction.

Example

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

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

    const innerHTML = await jsHandle.evaluate((node) => node.innerHTML);
    console.log(innerHTML); // <p><a href="/">&lt; Back</a></p>...
  } finally {
    await page.close();
  }
}