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

# waitForLoadState(state\[, options])

> Caution
> 
> This method has **known issues**. For details, refer to [#880](https://github.com/grafana/xk6-browser/issues/880).

This waits for the given load state to be reached. It will immediately unblock if that lifecycle event has already been received.

Expand table

| Parameter       | Type   | Default | Description                                                                                                                                                                                                                                                   |
|-----------------|--------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| state           | string | `load`  | Optional load state to wait for. See [Events](#events) for more details.                                                                                                                                                                                      |
| options         | object | `null`  |                                                                                                                                                                                                                                                               |
| 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/next/javascript-api/k6-browser/browsercontext/) or [Page](/docs/k6/next/javascript-api/k6-browser/page/). |

### Events

> Caution
> 
> `networkidle` is DISCOURAGED. Don’t use this method for testing especially with chatty websites where the event may never fire, rely on web assertions to assess readiness instead.

Events can be either:

- `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
- `'load'` - consider operation to be finished when the `load` event is fired.
- `'networkidle'` - Consider operation to be finished when there are no network connections for at least `500` ms.

### Returns

Expand table

| Type            | Description                                             |
|-----------------|---------------------------------------------------------|
| `Promise<void>` | A Promise that fulfills when the load state is reached. |