---
title: "evaluateHandle(pageFunction[, arg]) | Grafana k6 documentation"
description: "Browser module: JSHandle.evaluateHandle(pageFunction[, arg]) method"
---

# 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`](/docs/k6/latest/javascript-api/k6-browser/jshandle/evaluate/) and `evaluateHandle` is that `evaluateHandle` returns [JSHandle](/docs/k6/latest/javascript-api/k6-browser/jshandle/).

Expand table

| 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

Expand table

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

### Example

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```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 obj = await jsHandle.evaluateHandle((handle) => {
      return { innerText: handle.innerText };
    });
    console.log(await obj.jsonValue()); // {"innerText":"< Back...
  } finally {
    await page.close();
  }
}
```