mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
34 lines
739 B
Markdown
34 lines
739 B
Markdown
---
|
|
sidebar_label: ElementHandle.$
|
|
---
|
|
|
|
# ElementHandle.$() method
|
|
|
|
Runs `element.querySelector` within the page.
|
|
|
|
**Signature:**
|
|
|
|
```typescript
|
|
class ElementHandle {
|
|
$<Selector extends keyof HTMLElementTagNameMap>(
|
|
selector: Selector
|
|
): Promise<ElementHandle<HTMLElementTagNameMap[Selector]> | null>;
|
|
}
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | -------- | --------------------------- |
|
|
| selector | Selector | The selector to query with. |
|
|
|
|
**Returns:**
|
|
|
|
Promise<[ElementHandle](./puppeteer.elementhandle.md)<HTMLElementTagNameMap\[Selector\]> \| null>
|
|
|
|
`null` if no element matches the selector.
|
|
|
|
## Exceptions
|
|
|
|
`Error` if the selector has no associated query handler.
|