puppeteer/website/versioned_docs/version-19.0.0/api/puppeteer.frame._.md

sidebar_label
Frame.$

Frame.$() method

Queries the frame for an element matching the given selector.

Signature:

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

Parameters

Parameter	Type	Description
selector	Selector	The selector to query for.

Returns:

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

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