Skip to main content

JSHandle.evaluateHandle() method

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

Signature:

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

Parameters​

ParameterTypeDescription
pageFunctionFunc | string
argsParams

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.