Skip to content

wait

Wait for a condition to be met.

Bridge

Bridge required for --selector and --eval. The --title mode works without a bridge.

Usage

tauri-agent-tools wait [options]

Options

Option Description Default
-s, --selector <css> Wait for CSS selector to match an element —
-e, --eval <js> Wait for JS expression to be truthy —
-t, --title <regex> Wait for window with title (no bridge needed) —
--timeout <ms> Maximum wait time in milliseconds 10000
--interval <ms> Polling interval in milliseconds 500
--port <number> Bridge port (auto-discover if omitted) —
--token <string> Bridge token (auto-discover if omitted) —

One of --selector, --eval, or --title is required.

Examples

Wait for a DOM element

tauri-agent-tools wait --selector ".toast-message" --timeout 5000

found

Wait for a window to appear

tauri-agent-tools wait --title "My App" --timeout 10000

Outputs the window ID when found.

Wait for a JS condition

tauri-agent-tools wait --eval "document.readyState === 'complete'" --timeout 5000

Custom polling interval

tauri-agent-tools wait --selector ".loading-done" --interval 200 --timeout 30000

Behavior

  • --selector: polls document.querySelector() until a matching element exists
  • --eval: polls the JS expression until it returns a truthy value
  • --title: polls the platform adapter's findWindow() until a matching window appears
  • Throws an error if the condition is not met within --timeout
  • Exits with code 0 on success, non-zero on timeout