Skip to content
Zoan Docs

Win Wait For

Win Wait For

Section titled “Win Wait For”

Type: win-wait-for  ·  Package: Desktop Activities v1.0.0  ·  Output: boolean

Pause the flow until an element appears (visible) or disappears (hidden). It’s the essential tool for making desktop automations reliable: instead of guessing with a fixed Delay how long a window or control takes to load, you wait exactly until it’s ready.

How it works

Section titled “How it works”

Observe the item indicated by the selector and wait until it reaches the requested state (or until timeout is exhausted). As soon as it is fulfilled, the flow continues.

Required parameters

Section titled “Required parameters”
ParameterEditorDescription
selectorselectorThe element to wait for.

Optional parameters

Section titled “Optional parameters”
ParameterEditorDescription
sessionsessionWin Attach session. If omitted, the selector must include the window.
statelistEstado esperado: visible (aparecer, def.) · hidden (desaparecer).
timeoutnumberMaximum in ms to wait. By default 30000.

Output

Section titled “Output”

Returns a boolean:true if the element reached the expected state within the time.

Example

Section titled “Example”

Wait for the main window to load after logging in, and for a “Loading…” message to disappear:

Win Click   selector = (botón "Ingresar")
Win Wait For   selector = (etiqueta "Cargando...")   state = hidden     // esperar a que termine
Win Wait For   selector = (ventana "ERP — Inicio")   state = visible    // y a que aparezca
Section titled “Related activities”