***

title: page.locator
description: Create a locator bound to the current page.
--------------------------------------------------------

`page.locator` is a browser runtime capability in the `page` namespace.

## Availability

* Runtime: `browser`
* Kind: `raw`
* Category: `interaction`
* Supported drivers: Playwright, Puppeteer

## SDK Surface

* SDK path: `runtime.page.locator`
* Async: No

## HTTP Surface

* Transport: `workspace.execute(...)`
* Call: `page.locator`
* Long-running: No

## Reference Semantics

* Requires refs: `page`
* Returns refs: `locator`

## Arguments

| Argument   | Type     | Required | Description               |
| ---------- | -------- | -------- | ------------------------- |
| `selector` | `string` | Yes      | Selector for the locator. |

## Result

* Type: `locator`
* Description: Bound locator reference for follow-up steps.

## SDK Example

```ts
runtime.page.locator('button[type=submit]');
```

## HTTP Example

```json
{
  "runtime": "crm",
  "steps": [
    {
      "call": "page.locator",
      "args": [
        "button[type=submit]"
      ]
    }
  ]
}
```

## Related Capabilities

* [`locator.click`](../interaction/locator-click)
* [`locator.fill`](../interaction/locator-fill)
* [`locator.waitFor`](../interaction/locator-wait-for)