puppeteer/website/versioned_docs/version-16.0.0/api/puppeteer.elementhandle._.md
release-please[bot] 0c8bce13a2
chore(main): release 16.0.0 (#8729)
* chore(main): release 16.0.0

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-08-02 14:08:19 +00:00

720 B

sidebar_label
ElementHandle.$

ElementHandle.$() method

Runs element.querySelector within the page.

Signature:

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

Parameters

Parameter Type Description
selector Selector The 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.