BlinqIO Documentation

Waits Between Steps in AI Recorder ​

The AI Recorder provides two ways to pause test execution between steps:

  • Conditional Wait Step waits until an element meets a specific condition or the timeout expires
  • Sleep Step waits for a fixed amount of time

Use these options to handle timing issues caused by slow-loading pages, dynamic UI updates, or delayed element states.

Conditional Wait Step ​

The Conditional Wait step pauses execution until an element reaches a chosen state. This makes tests more reliable because they continue as soon as the condition is satisfied instead of waiting for a fixed delay.

  • If the condition is met within the timeout, execution proceeds immediately.
  • If not, the step waits for the entire timeout, shows a warning, and then moves to the next step. The scenario does not fail.

Add a Conditional Wait Step ​

  1. Open the AI Recorder and start editing or recording.
    image-20250627143031402

  2. Click + (Add a step type) and select Add a conditional wait step.
    cond-wait-1

  3. Select the element you want to apply the condition to.
    cond-wait-2

  4. Choose one of the available conditions:

    • Checked / Unchecked (for checkboxes, radio inputs, and option elements)
    • Visible / Hidden
    • Enabled / Disabled
    • Editable
      cond-wait-3

    INFO

    Available conditions depend on the element you select. The Recorder adjusts the list dynamically.

  5. Enter the timeout duration in milliseconds (default: 1000 ms). Increase it only if the condition usually takes longer. Click Save.
    image-20250709105421640

Behavior During Execution ​

  • If the condition is met before the timeout, execution continues to the next step immediately.
    cond-wait-4
  • If the condition is not met within the timeout, the Recorder waits the full duration, then logs a warning. Execution continues.
    cond-wait-error

How It Appears ​

  • In Features: Then Wait "X" seconds for element to be [condition]
    image-20250709110709633
  • In Reports:
    • Green when the condition is met in time
    • Warning if the timeout expires without the condition being met
      cond-wait-rep

Sleep Step ​

The Sleep step pauses execution for a fixed period of time. Use this when you know exactly how long to wait for a page or element to load.

  • Default wait time: 1000 ms (1 second)
  • You can set any duration in milliseconds

Add a Sleep Step ​

  1. Open the AI Recorder and start editing or recording a scenario.
    image-20250627143031402

  2. Click + (Add a step type) and select Add a sleep step.
    add-sleep-step-1

  3. Enter the wait time in milliseconds in the Timeout duration field. Click Save.
    image-20250627143410514

The step appears in the scenario list and pauses execution for the specified time during playback.

In the Features page, Sleep steps display as Sleep for X milliseconds.
image-20250617130211744

Choosing Between Sleep and Conditional Wait ​

  • Use Conditional Wait when dealing with dynamic UI states like loading spinners, disabled buttons, or visibility changes.
  • Use Sleep for short, predictable pauses where a specific time delay is required.

Best Practices

  • Prefer Conditional Wait to keep tests fast and reliable. It avoids unnecessary delays.
  • Start with short timeouts and only extend when needed.
  • Avoid long Sleep steps, as they slow down all test runs.
  • Document the reason for waits to help your team understand their purpose.