puppeteer/docs/api/puppeteer.page._.md

sidebar_label
Page.$

Page.$() method

Finds the first element that matches the selector. If no element matches the selector, the return value resolves to null.

Signature:

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

Parameters

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

**Returns:**

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

Remarks

Shortcut for Page.mainFrame().$(selector).