Skip to main content
Version: Next

Page.$$() method

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

Signature

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

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 quering 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.

options

QueryOptions

(Optional)

Returns:

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

Remarks

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