2022-07-05 13:41:43 +00:00
---
sidebar_label: ElementHandle.$eval
---
# ElementHandle.$eval() method
This method runs `document.querySelector` within the element and passes it as the first argument to `pageFunction` . If there's no element matching `selector` , the method throws an error.
If `pageFunction` returns a Promise, then `frame.$eval` would wait for the promise to resolve and return its value.
**Signature:**
```typescript
class ElementHandle {
$eval<
2022-07-06 07:05:37 +00:00
Selector extends string,
2022-07-05 13:41:43 +00:00
Params extends unknown[],
Func extends EvaluateFunc<
2022-07-06 07:05:37 +00:00
[ElementHandle< NodeFor < Selector > >, ...Params]
> = EvaluateFunc<[ElementHandle<NodeFor<Selector>>, ...Params]>
2022-07-05 13:41:43 +00:00
>(
selector: Selector,
pageFunction: Func | string,
...args: Params
): Promise< Awaited < ReturnType < Func > >>;
}
```
## Parameters
| Parameter | Type | Description |
| ------------ | -------------- | ----------- |
| selector | Selector | |
| pageFunction | Func \| string | |
| args | Params | |
**Returns:**
Promise< Awaited< ReturnType< Func> > >
## Example
```ts
const tweetHandle = await page.$('.tweet');
expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100');
expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
```
