Check / Uncheck

Check / Uncheck

Tipo: page-check  ·  Paquete: Browser v1.0.9

Marca o desmarca una casilla de verificación (checkbox) o un botón de opción (radio). A diferencia de un Click directo, garantiza el estado final que quieres: si pides marcar y ya estaba marcada, la deja marcada (no la cambia).

Cómo funciona

Localiza el elemento por su selector y lo lleva al estado indicado por checked: true lo marca, false lo desmarca. Por eso es más fiable que un clic, que simplemente alterna el estado.

• Si ya está en el estado pedido, no hace nada (es idempotente).
• Si no, espera a que sea accionable (como Click), hace clic y comprueba que el estado cambió; si no cambió, falla.
• Funciona con <input type="checkbox">, <input type="radio"> y elementos con role="checkbox" o role="radio". Un botón de opción no se puede desmarcar con checked = false: marca otro del mismo grupo.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
selector	selector	—	La casilla o botón de opción.

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).
checked	bool	true	true = marcar · false = desmarcar.
timeout	number	30000	Máximo en ms a esperar. Vacío, 0 o negativo: el de la configuración del proyecto o, si no hay, 30000.

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Page Check   selector = (#aceptoTerminos)                       // marcar (checked = true por defecto)
Page Check   selector = (#recibirPublicidad)   checked = false   // desmarcar
Page Check   selector = (#envioExpress)        checked = cliente["express"] == "S"

Mejor que un clic

Para casillas, prefiere Check / Uncheck sobre Click: así no dependes de si la casilla ya estaba marcada o no — siempre terminas en el estado que necesitas.

Errores comunes

Mensaje	Causa y solución
Check falló: Timeout 30000ms exceeded. … | coincidencias: 0 (…)	No encontró la casilla. Revisa el selector o espera antes con Wait For.
Check falló: Not a checkbox or radio button …	El selector apunta a otro elemento (por ejemplo, la etiqueta o un contenedor). Captura el input de la casilla.
Check falló: Clicking the checkbox did not change its state …	La página revierte el clic (casillas personalizadas con JavaScript). Usa Click sobre el elemento visible y verifica el resultado con Get Attribute.
'page' debe ser una ZoanPageSession.	No hay page y la actividad no está dentro de un body.

Actividades relacionadas

• Click — para elementos que no son casillas.
• Get Attribute — comprobar el estado leyendo el atributo checked.