Skip to main content

ElementHandle.$() method

Runs element.querySelector within the page.

Signature:
$<Selector extends keyof HTMLElementTagNameMap>(selector: Selector): Promise<ElementHandle<HTMLElementTagNameMap[Selector]> | null>;

Parameters

ParameterTypeDescription
selectorSelectorThe 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.