Spotted something off?Report on Discord
guides

Wait For Load State

Pause browser execution until a specific load state is reached before continuing with actions or data extraction.

Updated Feb 3, 2026

Pause the browser's execution until a specific load state is reached, ensuring actions and data extraction occur only after the page is ready.

Command

"wait_for_load_state"

One of the browser actions β€” use wait_for_selector to wait for a specific element, or wait_for_function to wait on a JavaScript condition.

Parameters

Parameter Type Required Description
waitForLoadState string Yes The load state to wait for. Options: domcontentloaded, networkidle, load

Example

bash12 lines
Want to run this request directly in your browser?to try it live with your own API key.

Notes

State Description
domcontentloaded Fired when the DOM is fully loaded (before styles/images/etc).
networkidle Waits until there are no network requests for 500 ms.
load Waits for the full load event including images and resources.