mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
2d5f216621
* chore(main): release 16.1.0 * chore: generate versioned docs Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
34 lines
720 B
Markdown
34 lines
720 B
Markdown
---
|
|
sidebar_label: ElementHandle.$
|
|
---
|
|
|
|
# ElementHandle.$() method
|
|
|
|
Runs `element.querySelector` within the page.
|
|
|
|
**Signature:**
|
|
|
|
```typescript
|
|
class ElementHandle {
|
|
$<Selector extends string>(
|
|
selector: Selector
|
|
): Promise<ElementHandle<NodeFor<Selector>> | null>;
|
|
}
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | -------- | --------------------------- |
|
|
| selector | Selector | The selector to query with. |
|
|
|
|
**Returns:**
|
|
|
|
Promise<[ElementHandle](./puppeteer.elementhandle.md)<[NodeFor](./puppeteer.nodefor.md)<Selector>> \| null>
|
|
|
|
`null` if no element matches the selector.
|
|
|
|
## Exceptions
|
|
|
|
`Error` if the selector has no associated query handler.
|