Skip to main content
Version: 22.14.0

Page.locator() method

Creates a locator for the provided selector. See Locator for details and supported actions.

Signature:

class Page {
locator<Selector extends string>(
selector: Selector
): Locator<NodeFor<Selector>>;
}

Parameters

Parameter

Type

Description

selector

Selector

selector to query 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.

Returns:

Locator<NodeFor<Selector>>