Wait For

Tipo: page-wait-for · Paquete: Browser v1.0.0

Pausa el flujo hasta que un elemento alcance el estado que indiques. Es la herramienta esencial para que tus automatizaciones web sean fiables: en lugar de adivinar con un Delay fijo cuánto tarda una página, esperas exactamente a que el elemento que necesitas esté listo.

Cómo funciona

Observa el elemento indicado por el selector y espera hasta que llegue al state pedido (o hasta agotar timeout, en cuyo caso falla). En cuanto se cumple, el flujo continúa de inmediato — ni antes ni más tarde.

Parámetros requeridos

Parámetro	Editor	Descripción
`selector`	selector	El elemento a esperar.

Parámetros opcionales

Parámetro	Editor	Descripción
`page`	sesión	La sesión de página. Omítela dentro de un `body`; fuera, pasa `= page`.
`state`	lista	Estado a esperar: `visible` (def.) · `hidden` (oculto) · `attached` (presente en el HTML) · `detached` (ya no está).
`timeout`	número	Máximo en ms a esperar. Por defecto `30000`.

Estados

Estado	Espera a que el elemento…
`visible`	Aparezca y sea visible (lo más usado)
`hidden`	Se oculte (ej. un spinner de carga que desaparece)
`attached`	Exista en el HTML, aunque no sea visible
`detached`	Deje de existir en el HTML

Ejemplo

Esperar a que cargue el dashboard tras iniciar sesión, y a que desaparezca el spinner:

Page Click   selector = (#entrar)
Page Wait For   selector = (.spinner-carga)   state = hidden    // esperar a que termine de cargar
Page Wait For   selector = (.dashboard)       state = visible   // y a que aparezca el contenido

Actividades relacionadas

Element Exists — comprobar presencia sin fallar (devuelve true/false).
Navigate — su parámetro waitUntil controla la espera de carga de página.
Delay — espera fija (menos fiable; úsala como último recurso).