Win Wait For

Win Wait For

Tipo: win-wait-for  ·  Paquete: Desktop Activities v1.0.8  ·  Salida: boolean

Pausa el flujo hasta que un elemento aparezca (visible) o desaparezca (hidden). Es la herramienta esencial para que las automatizaciones de escritorio sean fiables: en lugar de adivinar con un Delay fijo cuánto tarda una ventana o un control en cargar, esperas exactamente a que esté listo.

Cómo funciona

Busca el elemento indicado por el selector cada 250 ms hasta que alcance el state pedido. En cuanto se cumple, el flujo continúa; si se agota timeout, la actividad falla.

• visible: espera a que el elemento se pueda localizar.
• hidden: espera a que deje de poder localizarse. Si ya no está al empezar, continúa de inmediato.
• No interactúa con la aplicación ni la trae al frente.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	El elemento a esperar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanDesktopSession	—	Sesión de Win Attach. Dentro de un body se toma sola; sin sesión, el selector debe incluir la ventana.
state	string	visible	Estado esperado: visible (aparecer) · hidden (desaparecer).
timeout	number	30000	Máximo en ms a esperar. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Salida

Devuelve un boolean: siempre true cuando el elemento alcanza el estado esperado. Si no lo alcanza, la actividad falla (no devuelve false); para una comprobación que no falle, usa Win Element Exists.

Errores comunes

Mensaje	Causa y solución
Se agotó el tiempo de espera para que apareciera el elemento.	El elemento no apareció en timeout. Sube timeout si la aplicación es lenta, o revisa el selector en UI Discover.
Se agotó el tiempo de espera para que desapareciera el elemento.	El elemento seguía ahí al agotarse timeout (un “Cargando…” que no termina). Revisa la aplicación o sube timeout.
'selector' es obligatorio.	Falta el selector o no es válido.

Con sesión, se busca dentro de su ventana

Dentro del body de un Win Attach el nodo de ventana del selector se ignora: Win Wait For no puede esperar otra ventana de nivel superior desde ahí. Para esperar una ventana nueva, usa un Win Attach a esa ventana (que espera hasta su timeout) fuera del body.

Ejemplo

Esperar a que desaparezca un mensaje de “Cargando…” y a que aparezca el resultado:

Win Click      selector = (botón "Consultar")
Win Wait For   selector = (etiqueta "Cargando...")   state = hidden     // esperar a que termine
Win Wait For   selector = (tabla "Resultados")       state = visible    // y a que aparezca
Win Extract Table   selector = (tabla "Resultados")   → output: resultados

La clave de la fiabilidad en escritorio

Antes de leer o hacer clic en algo que aparece tras una acción (login, abrir una ventana, ejecutar un proceso), pon un Win Wait For. Es la diferencia entre un bot estable y uno que falla cuando la app va lenta. Evita los Delay fijos siempre que puedas.

Actividades relacionadas

• Win Element Exists — comprobar presencia sin fallar (true/false).
• Win Get Attribute — consultar enabled y otros estados.