Skip to main content
Version: Next

ElementHandle.$() method

Runs element.querySelector within the page.

Signature:

class ElementHandle {
$<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.