Skip to main content
Version: Next

ElementHandle.$() method

Runs element.querySelector within the page.

Signature:

class ElementHandle {
$<Selector extends string>(
selector: Selector
): Promise<ElementHandle<NodeFor<Selector>> | null>;
}

Parameters

ParameterTypeDescription
selectorSelectorThe selector to query with.

Returns:

Promise<ElementHandle<NodeFor<Selector>> | null>

null if no element matches the selector.

Exceptions

Error if the selector has no associated query handler.