puppeteer/docs/api/puppeteer.elementhandle._.md

sidebar_label
ElementHandle.$

ElementHandle.$() method

Runs element.querySelector within the page.

Signature:

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<HTMLElementTagNameMap[Selector]> | null>

null if no element matches the selector.

Exceptions

Error if the selector has no associated query handler.