ElementHandle.$() method
Queries the current element for an element matching the given selector.
Signature
class ElementHandle {
$<Selector extends string>(
selector: Selector,
): Promise<ElementHandle<NodeFor<Selector>> | null>;
}
Parameters
Parameter | Type | Description |
---|---|---|
selector | Selector | selector to query the page for. CSS selectors can be passed as-is and a Puppeteer-specific selector syntax allows quering by text, a11y role and name, and xpath and combining these queries across shadow roots. Alternatively, you can specify the selector type using a prefix. |
Returns:
Promise<ElementHandle<NodeFor<Selector>> | null>
A element handle to the first element matching the given selector. Otherwise, null
.