1.3 KiB
1.3 KiB
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);