puppeteer/website/versioned_docs/version-9.1.1/puppeteer.frame._eval.md

Home > puppeteer > Frame > $eval

Frame.$eval() method

Signature:

$eval<ReturnType>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;

Parameters

Parameter	Type	Description
selector	string	the selector to query for
pageFunction	(element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>	the function to be evaluated in the frame's context
args	SerializableOrJSHandle[]	additional arguments to pass to pageFunction

Returns:

Promise<WrapElementHandle<ReturnType>>

Remarks

This method runs document.querySelector within the frame and passes it as the first argument to pageFunction.

If pageFunction returns a Promise, then frame.$eval would wait for the promise to resolve and return its value.

Example

const searchValue = await frame.$eval('#search', el => el.value);