Wait Node (TimeWait)

The TimeWait node inserts a fixed pause so UI loading, async jobs, or external systems can finish before the workflow continues. When paired with mouse/keyboard nodes, it reduces “click before ready” failures.

Configuration

Field	Type	Required	Description
`name`	`string`	✔️	Node name, e.g. `wait-for-popup`.
`duration`	`number`	✔️	Wait time in milliseconds (`2000` → 2 seconds).
`conditions`	`Conditions`		Optional guards so waits only run in specific environments.

TimeWait has no retry, interval, or err_return. Once the timer completes the next node runs.

YAML Examples


- action_type: TimeWait
  name: wait-for-dialog
  duration: 1500


- action_type: TimeWait
  name: wait-after-login
  duration: 3000
  conditions:
    env: prod

The first example pauses unconditionally for 1.5 seconds; the second only waits in production to keep test runs snappy.

Usage Tips

Choose durations that are “long enough but not wasteful” to avoid unnecessary delays.
When possible, prefer condition-based checks (e.g. image recognition) over fixed delays.
Combine with MouseMove, MouseClick, or Keyboard nodes to build stable “wait → act” flows.