Waiting conditions

Smart waiting before running a step

Before running each test step, BugBug will do a series of checks if your page is ready for this action.

For example, before BugBug tries to click a button, it will check if the page finished loading, if the button exists and if it's visible. If those conditions are met, BugBug will attempt to click the button. Such conditions are called "Waiting conditions".


  • more stable tests

  • you don't need to hardcode manual delays

  • more intelligent tests running, behaving more like a human and not a machine

Available waiting conditions

Document readyState is complete

BugBug waits until your page is ready to interact with and if all the basic assets are loaded. In technical terms this is waiting for onload window event.

Page network requests are finished

BugBug waits until your page has finished loading additional data via other network requests.

Even after the page is loaded, your web app needs to request additional data from a server. BugBug will wait until your server requests are more or less finished - by default BugBug will stop waiting when there are not more than 2 unfinished requests for more than 1 second. You can change this in Project Settings.

Element is visible

BugBug will not interact with the element until it is visible. For example, if you have a "Done" button than only appears after several seconds, BugBug will wait until it appears. That's why you should avoid adding manual delays/sleep.

Element is not covered by the other one

Same as in "Element is visible" above. BugBug will try not to click something that is covered by another element.

Element is not animating

This ensures that the animation of the element stopped before BugBug interacts with it.

For example, if you have a collapsed section that expands with an animation, BugBug will wait until it is fully expanded before interacting with its contents.

This waiting condition is enabled if during the recording you clicked an element that was not animating. If the element has a looping animation, BugBug will disable this waiting condition by default.

Element must be active

This applies to form elements, that can have a disabled attribute. BugBug will hold the step execution until the form element is active. This waiting condition is automatically disabled if during the recording you actually clicked on a disabled element.

Element has focus

This applies to text input elements. BugBug will wait before typing the letters until it verifies that a text input or textarea has focus, (meaning that the blinking typing cursor is present the right field)

Page will navigate after step execution

This is a special waiting condition that is added automatically by BugBug while recording. If BugBug notices that after a click there's a change in the URL, BugBug will not continue running the next step immediately - it will wait until the URL changes. This also applies to URL history state changes for Single Page Applications.

Enable or disable waiting conditions

Global waiting conditions can be set up in the project settings.

You can override waiting conditions per each step. Sometimes you need to disable one of them to prevent unnecessary failed tests.

Skipped waiting conditions

If some waiting conditions are not met, BugBug will anyway try to perform the action. For example, if the page networking has not finished, BugBug will anyway click the button after 30 seconds.

More about test statues

Last updated