puppeteer.webworker.evaluatehandle.md

Home > puppeteer > WebWorker > evaluateHandle

WebWorker.evaluateHandle() method

The only difference between worker.evaluate and worker.evaluateHandle is that worker.evaluateHandle returns in-page object (JSHandle). If the function passed to the worker.evaluateHandle returns a [Promise], then worker.evaluateHandle would wait for the promise to resolve and return its value. Shortcut for await worker.executionContext()).evaluateHandle(pageFunction, ...args)

Signature:

evaluateHandle<HandlerType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;

Parameters

Parameter	Type	Description
pageFunction	EvaluateHandleFn	Function to be evaluated in the page context.
args	SerializableOrJSHandle[]	Arguments to pass to pageFunction.

Returns:

Promise<JSHandle>

Promise which resolves to the return value of pageFunction.