puppeteer/docs/api/puppeteer.page.locator.md

sidebar_label
Page.locator

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 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:**

Locator<NodeFor<Selector>>

Remarks

Locators API is experimental and we will not follow semver for breaking change in the Locators API.