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

Documentationbreadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/browserbreadcrumb arrow Locatorbreadcrumb arrow evaluateHandle(pageFunction[, arg])
Open source

evaluateHandle(pageFunction[, arg])

Executes JavaScript code in the page, passing the matching element of the locator 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.

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

Returns

TypeDescription
PromiseA JSHandle of the 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://quickpizza.grafana.com", { waitUntil: "load" });

    await page.getByText('Pizza, Please!').click();

    const jsHandle = await page.locator('#pizza-name').evaluateHandle((pizzaName) => pizzaName);

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