puppeteer/website/versioned_docs/version-15.3.0/api/puppeteer.jshandle.evaluatehandle.md
release-please[bot] 01c76b7eb1
chore(main): release 15.3.0 (#8606)
* chore(main): release 15.3.0

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-07-01 17:02:54 +02:00

1.2 KiB

sidebar_label
JSHandle.evaluateHandle

JSHandle.evaluateHandle() method

This method passes this handle as the first argument to pageFunction.

Signature:

class JSHandle {
  evaluateHandle<
    Params extends unknown[],
    Func extends EvaluateFunc<[this, ...Params]> = EvaluateFunc<
      [this, ...Params]
    >
  >(
    pageFunction: Func | string,
    ...args: Params
  ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
}

Parameters

Parameter Type Description
pageFunction Func | string
args Params

Returns:

Promise<HandleFor<Awaited<ReturnType<Func>>>>

Remarks

The only difference between jsHandle.evaluate and jsHandle.evaluateHandle is that jsHandle.evaluateHandle returns an in-page object (JSHandle).

If the function passed to jsHandle.evaluateHandle returns a Promise, then evaluateHandle.evaluateHandle waits for the promise to resolve and returns its value.

See Page.evaluateHandle() for more details.