Files
puppeteer/docs/api/puppeteer.elementhandle._.md
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>Nikolay Vitkov
4afe06b61d chore(deps-dev): Bump the dev-dependencies group with 14 updates (#13982)
Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Nikolay Vitkov <[email protected]>
2025-07-02 08:16:05 +00:00

1.5 KiB

sidebar_label
sidebar_label
ElementHandle.$

ElementHandle.$() method

Queries the current element for an element matching the given selector.

Signature

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

Parameters

Parameter

Type

Description

selector

Selector

selector to query the page for. CSS selectors can be passed as-is and a Puppeteer-specific selector syntax allows querying by text, a11y role and name, and xpath and combining these queries across shadow roots. Alternatively, you can specify the selector type using a prefix.

Returns:

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

A element handle to the first element matching the given selector. Otherwise, null.