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.