***

title: locator.waitFor
description: Wait for the matched element to reach the requested state.
-----------------------------------------------------------------------

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

## Availability

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

## SDK Surface

* SDK path: `runtime.page.locator(...).waitFor`
* Async: Yes

## HTTP Surface

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

## Reference Semantics

* Requires refs: `locator`

## Arguments

| Argument  | Type     | Required | Description                    |
| --------- | -------- | -------- | ------------------------------ |
| `options` | `object` | No       | Visibility/state wait options. |

## Result

* Type: `void`
* Description: Resolves when the locator reaches the requested state.

## SDK Example

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

## HTTP Example

```json
{
  "runtime": "crm",
  "steps": [
    {
      "call": "locator.waitFor"
    }
  ]
}
```

## Related Capabilities

* [`locator.click`](../interaction/locator-click)
* [`page.waitForEvent`](../events/page-wait-for-event)