Click

Tipo: page-click · Paquete: Browser v1.0.9 · Salida: ZoanPageSession

Hace clic en un elemento de la página (un botón, un enlace, una casilla). Es la actividad de interacción más común: cualquier acción que en el navegador harías con el mouse. Si el clic abre una pestaña nueva, puede esperarla y devolverte su sesión para seguir trabajando en ella.

Cómo funciona

Localiza el elemento indicado por el selector, espera a que sea accionable (visible, quieto, habilitado y sin otro elemento encima; lo desplaza a la vista si hace falta) y hace clic. Si no lo logra dentro de timeout, la actividad falla con un mensaje que explica la causa. Puedes elegir el botón del mouse y el número de clics (para doble clic).

Clics que abren una pestaña nueva

Con expectNewTab = true, la actividad empieza a escuchar antes de hacer clic, así que no se pierde la pestaña aunque aparezca al instante:

Hace el clic.
Espera hasta newTabTimeout a que se abra la pestaña nueva (un target="_blank", una ventana emergente).
Espera a que su HTML esté cargado (DOMContentLoaded) y la devuelve como salida.

Sin esta opción, la pestaña se abre igual pero el playbook no la tiene a mano; tendrías que buscarla después con Switch Page.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El elemento al que hacer clic. Captúralo con el selector visual o escribe un CSS.

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`).
`button`	`string`	`"left"`	Botón del mouse: `left` · `right` · `middle`.
`clickCount`	`int`	`1`	Número de clics: `1` (clic) · `2` (doble clic).
`timeout`	`number`	`30000`	Máximo en ms a esperar a que el elemento sea accionable. Vacío, `0` o negativo: el de la configuración del proyecto o, si no hay, `30000`.
`expectNewTab`	`bool`	`false`	El clic abre una pestaña nueva: la espera y la devuelve como salida.
`newTabTimeout`	`number`	`15000`	Máximo en ms a esperar la pestaña nueva (solo con `expectNewTab`). `0` o negativo: el valor por defecto.

Salida

Con expectNewTab = true: una ZoanPageSession de la pestaña nueva, ligada al mismo navegador (comparte cookies e inicio de sesión con la pestaña original). La pestaña original sigue abierta y su sesión sigue sirviendo.
Sin expectNewTab: no devuelve ningún valor.

Ejemplo

Page Click   selector = (#botonGuardar)
Page Click   selector = (.fila-resultado)   clickCount = 2     // doble clic
Page Click   selector = (#menu)             button = right     // clic derecho

Abrir el detalle de un pedido que se muestra en otra pestaña y leer su estado:

Page Click      page = page   selector = (#verDetalle)   expectNewTab = true   → output: detalle
Page Get Text   page = detalle   selector = (.estado)   → output: estado
Close Page      page = detalle

Errores comunes

Mensaje	Causa y solución
`Click falló: Timeout 30000ms exceeded. … \| coincidencias: 0 (elemento no encontrado: …)`	El selector no encontró el elemento: la página no terminó de cargar, está en un `iframe` o el selector quedó desactualizado. Recaptura el selector o añade un Wait For previo.
`Click falló: … \| coincidencias: 1 (el elemento existe pero la acción no se completó: …)`	El elemento está oculto, deshabilitado o tapado (un modal, un aviso de cookies). Cierra lo que lo tapa o espera a que se habilite.
`Click falló: … \| coincidencias: 3 (el selector es ambiguo: …)`	El selector coincide con varios elementos. Usa un selector más específico (id, texto único), un índice o un ancla.
`Timeout 15000ms exceeded …` esperando la pestaña nueva	Con `expectNewTab`, el clic no abrió ninguna pestaña a tiempo (o la abrió en la misma). Sube `newTabTimeout`, o quita `expectNewTab` si el enlace navega en la misma pestaña.
`'page' debe ser una ZoanPageSession.`	No hay `page` y la actividad no está dentro de un `body`. Pasa `page = page`.

Actividades relacionadas

Hover — pasar el mouse sin hacer clic (menús desplegables).
Wait For — asegurar que el elemento está listo.
Element Exists — comprobar si el elemento está antes de actuar.
Switch Page — tomar una pestaña abierta por otros medios.