Files
browser-automation-botGitHubrelease-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
4d7b677d1d chore: release main (#15201)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2026-07-27 14:29:23 +02:00

2.1 KiB

sidebar_label
sidebar_label
Page.locator

Page.locator() method

locator(): Locator<NodeFor<Selector>>

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

Returns:

Locator<NodeFor<Selector>>

locator(): Locator<Ret>

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

Signature

class Page {
  locator<Ret>(func: () => Awaitable<Ret>): Locator<Ret>;
}

Parameters

Parameter

Type

Description

func

() => Awaitable<Ret>

Returns:

Locator<Ret>