Page.$$() method

Finds elements on the page that match the selector. If no elements match the selector, the return value resolves to [].

Signature

typescript

class Page {
  $$<Selector extends string>(
    selector: Selector,
    options?: QueryOptions,
  ): Promise<Array<ElementHandle<NodeFor<Selector>>>>;
}

Parameters

Parameter

</th><th>

Type

</th><th>

Description

</th></tr></thead> <tbody><tr><td>

selector

</td><td>

Selector

</td><td>

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.

</td></tr> <tr><td>

options

</td><td>

QueryOptions

</td><td>

(Optional)

</td></tr> </tbody></table>

Returns:

Promise<Array<ElementHandle<NodeFor<Selector>>>>

Remarks

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