Hover

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

Mueve el puntero del mouse sobre un elemento, sin hacer clic. Sirve para activar comportamientos que solo aparecen al pasar el cursor por encima: menús desplegables, tooltips, botones que se revelan, submenús de navegación.

Cómo funciona

Localiza el elemento por su selector, espera a que sea visible, esté quieto y no lo tape otro elemento (lo desplaza a la vista si hace falta) y posiciona el mouse en su centro, disparando sus eventos hover/mouseover. Lo típico es seguirlo de un Click sobre la opción que se reveló. El puntero se queda ahí hasta la siguiente acción del mouse.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El elemento sobre el que pasar el mouse.

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`	`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

Abrir un menú que aparece al pasar el mouse y hacer clic en una opción:

Page Hover   selector = (#menuUsuario)
Page Wait For   selector = (.opcion-cerrar-sesion)   state = visible
Page Click   selector = (.opcion-cerrar-sesion)

Errores comunes

Mensaje	Causa y solución
`Hover falló: Timeout 30000ms exceeded. … \| coincidencias: 0 (…)`	No encontró el elemento. Revisa el selector o espera antes con Wait For.
`Hover falló: … \| coincidencias: 1 (el elemento existe pero la acción no se completó: …)`	El elemento está oculto o tapado por otro. Cierra lo que lo cubre.
`'page' debe ser una ZoanPageSession.`	`page` está vacío fuera de un `body`.

Actividades relacionadas

Click — hacer clic en la opción revelada por el hover.
Wait For — esperar a que el submenú aparezca.