puppeteer/new-docs/puppeteer.webworker.evaluatehandle.md
Martin Splitt 44402b75a0
feat(new-docs): add tsdoc comments to WebWorker (#6029)
* feat(new-docs): add TSDoc comments to `WebWorker`

Co-authored-by: martinsplitt <martin@geekonaut.de>
2020-06-17 16:26:10 +01:00

1.2 KiB

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)](#executioncontextevaluatehandlepagefunction-args).

Signature:

evaluateHandle(pageFunction: Function | string, ...args: any[]): Promise<JSHandle>;

Parameters

Parameter Type Description
pageFunction Function | string Function to be evaluated in the page context.
args any[] Arguments to pass to pageFunction.

Returns:

Promise<JSHandle>

Promise which resolves to the return value of pageFunction.