Element Exists

Element Exists

Tipo: page-element-exists  ·  Paquete: Browser v1.0.9  ·  Salida: bool

Comprueba si un elemento existe y es visible en la página, y devuelve true o false. A diferencia de otras actividades, no falla si el elemento no está: simplemente devuelve false. Es la forma de manejar páginas que a veces muestran algo y a veces no — un mensaje de error, un banner de cookies, un resultado de búsqueda.

Cómo funciona

Busca el elemento por su selector. Por defecto (timeout = 0) hace una comprobación inmediata. Si pones un timeout mayor, espera hasta ese tiempo a que el elemento aparezca y sea visible antes de devolver false. El resultado típicamente alimenta un If.

• Si el selector coincide con varios elementos, no falla: mira el primero.
• Un elemento que existe en el HTML pero está oculto devuelve false.
• No usa el tiempo de espera de la configuración del proyecto: sin timeout, la comprobación siempre es inmediata.

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
page	ZoanPageSession	—	La sesión de página. Omítela dentro de un body; fuera, pasa la variable de la sesión (p. ej. page = page).
timeout	number	0	Máximo en ms a esperar a que aparezca y sea visible. 0: comprobación inmediata.

Salida

Devuelve un bool: true si el (primer) elemento existe y es visible; false si no existe, está oculto o no apareció dentro de timeout.

Ejemplo

Cerrar un banner de cookies solo si aparece:

Page Element Exists   selector = (#banner-cookies)   timeout = 3000   → output: hayBanner
If   condition = hayBanner
 └─ then:
      Page Click   selector = (#aceptar-cookies)

Element Exists vs Wait For

• Element Exists: pregunta “¿está?” y devuelve true/false. No detiene el flujo si no está.
• Wait For: espera a que un elemento llegue a un estado y falla si no ocurre. Úsalo cuando el elemento debe aparecer.

Errores comunes

Prácticamente no falla por el elemento: cualquier problema al buscarlo devuelve false. Solo falla antes de buscar:

Mensaje	Causa y solución
Ningún elemento coincide con el selector, así que no se pueden aplicar las anclas.	El selector tiene anclas y en ese momento no había ningún candidato. Para una comprobación que no falle, usa un selector sin anclas.
'page' debe ser una ZoanPageSession.	page está vacío fuera de un body.

Actividades relacionadas

• Wait For — esperar (y exigir) que un elemento aparezca.
• If — ramificar según el resultado.