---
title: "waitForSelector(selector[, options]) | Grafana k6 documentation"
description: "Browser module: frame.waitForSelector(selector[, options]) method"
---

# waitForSelector(selector\[, options])

> Note
> 
> Use web assertions that assert visibility or a locator-based [`locator.waitFor([options])`](/docs/k6/latest/javascript-api/k6-browser/locator/waitfor/) instead.

Returns when element specified by selector satisfies `state` option.

Expand table

| Parameter       | Type    | Default   | Description                                                                                                                                                                                                                                                       |
|-----------------|---------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| selector        | string  | `''`      | A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.                                                                                                                                              |
| options         | object  | `null`    |                                                                                                                                                                                                                                                                   |
| options.state   | string  | `visible` | Can be either `attached`, `detached`, `visible`, `hidden` See [Element states](#element-states) for more details.                                                                                                                                                 |
| options.strict  | boolean | `false`   | When `true`, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception.                                                                                                        |
| options.timeout | number  | `30000`   | Maximum time in milliseconds. Pass `0` to disable the timeout. Default is overridden by the `setDefaultTimeout` option on [BrowserContext](/docs/k6/latest/javascript-api/k6-browser/browsercontext/) or [Page](/docs/k6/latest/javascript-api/k6-browser/page/). |

### Element states

Element states can be either:

- `'attached'` - wait for element to be present in DOM.
- `'detached'` - wait for element to not be present in DOM.
- `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`.
- `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.

### Returns

Expand table

| Type                            | Description                                                                                                                                                                    |
|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Promise<ElementHandle | null>` | A Promise that fulfills with the [ElementHandle](/docs/k6/latest/javascript-api/k6-browser/keyboard/) when a matching element is found, or `null` if the element is not found. |