Win Element Exists

Tipo: win-element-exists · Paquete: Desktop Activities v1.0.8 · Salida: boolean

Comprueba si un elemento existe en la aplicación y devuelve true o false. No falla si el elemento no está: simplemente devuelve false. Es la forma de manejar interfaces que a veces muestran algo —un diálogo de error, un mensaje, un botón condicional.

Cómo funciona

Busca el elemento por su selector. Por defecto (timeout = 0) hace una comprobación inmediata, sin usar el tiempo de espera del proyecto. Con un timeout mayor, reintenta cada 250 ms hasta ese tiempo antes de devolver false. El resultado suele alimentar un If.

Solo se buscan ventanas visibles; dentro de ellas, cuenta que el control se pueda localizar (no comprueba si está desplazado fuera de la vista).
Cualquier problema al buscar (un selector ambiguo, una ventana que se cierra a media consulta) cuenta como “no existe”.
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 comprobar.

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.
`timeout`	`number`	`0`	Máximo en ms a esperar a que aparezca. `0` = comprobación inmediata.

Salida

Devuelve un boolean: true si el elemento se encontró dentro del tiempo; false si no.

Errores comunes

Mensaje	Causa y solución
`'selector' es obligatorio.`	Falta el selector o no es válido. Captúralo con UI Discover.

Fuera de eso, la actividad no falla: un selector sin nodo de ventana y sin sesión simplemente devuelve false, así que revisa el selector si siempre obtienes false.

Ejemplo

Cerrar un diálogo de aviso solo si aparece:

Win Element Exists   selector = (diálogo "Aviso")   timeout = 2000   → output: hayAviso
If   condition = hayAviso
 └─ then:
      Win Click   selector = (botón "Aceptar")

Actividades relacionadas

Win Wait For — esperar (y exigir) un estado.
Win Get Attribute — consultar otras propiedades.