Volver al Centro de conocimiento
Primeros pasos

Esperas de Selenium WebDriver para pruebas estables

Cómo elegir esperas de Selenium a partir de contratos observables del navegador para mantener pruebas autorizadas legibles y estables.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Primeros pasos?

Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.

Una prueba de Selenium avanza por un contrato de estado, una espera explícita y una aserción visible

Resumen

  • Cada espera nombra una frontera del navegador y una consecuencia: visibility_of_element_located responde si un elemento se ve, element_to_be_clickable añade el estado habilitado, y ninguna de las dos demuestra que terminó una actualización del servidor.
  • Separa localizador, estado usable, clic y resultado en pasos distintos para que el fallo diga qué contrato faltó en lugar de solo que se agotó el tiempo.
  • Clasifica la excepción antes de tocar el tiempo de espera: StaleElementReferenceException significa que la aplicación reemplazó el nodo, ElementNotInteractableException se refiere a la interacción con el elemento, un clic obstruido puede generar ElementClickInterceptedException y TimeoutException significa que el estado esperado nunca llegó.
  • Guarda la estrategia de carga en el registro, porque normal vuelve cuando document.readyState es complete, eager vuelve con el DOM interactivo y none vuelve sin esperar nada.
  • BotBrowser aporta un perfil repetible para un recorrido autorizado; no sustituye la política de esperas, el contrato de preparación de la aplicación ni el bloque finally que llama a driver.quit().

Contenido

Por qué una espera es un contrato, no una pausa

Al comparar esta sincronización con una migración de framework, las alternativas a Selenium y sus cambios prácticos ayudan a revisar esperas junto con protocolo, propiedad del navegador y evidencia de fallo.

En una extracción de datos, la espera solo establece que la página está lista; el flujo de scraping con Selenium registra por separado las capacidades de sesión y valida las filas obtenidas con un esquema.

Una pausa solo confirma que transcurrió tiempo. Una espera útil declara qué estado puede observar la prueba y qué ocurre si ese estado no llega. Así el fallo separa una ejecución lenta de una página que nunca alcanzó su estado previsto. BotBrowser puede dar a un entorno de pruebas controlado un perfil coherente con el que ejecutarse; no puede arreglar una espera mal elegida ni cambiar cómo se comporta WebDriver o una página.

Un recorrido del navegador contiene varias fronteras asíncronas: navegación, activación de un control, llegada de datos, aparición de una ventana o inserción de un marco. Cada frontera merece su propia observación y su propio límite. Para la observación basada en eventos, consulte eventos WebDriver BiDi para una automatización estable.

Empiece con el resultado visible para la persona usuaria. Una cabecera de confirmación, una región de estado o un enlace operable describen mejor el contrato que un retraso supuesto después de pulsar un botón. Consulte la documentación de Selenium WebDriver para el protocolo y documente el contrato en la aplicación.

Relacione cada espera con su frontera

Una condición explícita debe tener una sola responsabilidad. La visibilidad responde si algo puede verse; la condición de clic combina visibilidad y habilitación. Ninguna demuestra por sí sola que terminó una actualización remota.

Prefiera una propiedad estable y documentada frente a una clase usada durante una animación. Un atributo de disponibilidad respaldado por la aplicación ofrece una señal más clara que el final accidental de un efecto visual.

La guía de esperas de Selenium distingue esperas implícitas, explícitas y fluidas. Mantenga sencilla la política implícita y use una espera explícita en la frontera que la necesita, con un límite apropiado al entorno aprobado.

Haga que los localizadores expresen el estado

Un localizador basado en etiqueta visible, rol accesible o identificador estable comunica por qué importa el elemento. Una clase generada o una posición de tabla puede cambiar sin que cambie la función. Los roles y nombres accesibles también sirven a las comprobaciones de accesibilidad, como se explica en pruebas de accesibilidad con automatización del navegador.

Separe encontrar el control de comprobar su estado. Localice el botón, espere a que esté habilitado, actúe una vez y espere la región de confirmación. En una ruta negativa, espere el mensaje de validación previsto.

Un ayudante repetido debe llevar el nombre del contrato de la aplicación. esperar_confirmacion_pedido explica la intención; esperar_pagina_lista deja demasiadas posibilidades. Conserve la aserción en la superficie semántica que ve la persona usuaria. Para las transferencias de archivos, consulte pruebas limpias de carga y descarga en la automatización del navegador.

Mantenga explícitas navegación, marcos y ventanas

Llegar a una URL no prueba que la vista principal esté lista. Espere el estado documental o un hito visible y haga después la aserción de resultado. No convierta cada prueba en una espera de red que la persona no puede observar.

Después de abrir una ventana, espere el nuevo identificador, cambie de contexto y espere su hito. Para un marco dinámico, espere a que esté disponible, cambie dentro de él y vuelva deliberadamente al contexto original. Si el renderizado reemplaza un anfitrión shadow, vuelva a obtener el anfitrión, su raíz con host.shadow_root y el descendiente como muestra el diagnóstico de Shadow DOM en Selenium, y mantenga la acción fuera de la condición de espera.

Describa también el límite: una ventana puede bloquearse, un marco puede no aparecer o una redirección puede llevar a una ruta de acceso admitida. No repita automáticamente una acción que quizá ya tuvo éxito; una repetición autorizada debe crear una sesión propia y dejar constancia.

Sustituya conjeturas temporales por evidencia

El diagnóstico de element not interactable según el comando reproduce un duplicado oculto y lo distingue de un clic interceptado y de un campo de solo lectura. Identifique el comando que falla antes de elegir una condición de espera.

Un tiempo agotado debe nombrar la condición ausente e incluir localizador o estado, URL actual, versiones de navegador y controlador y número de intento. Las capturas deben respetar las reglas de artefactos y privacidad.

Clasifique un elemento obsoleto, un elemento no interactuable y un tiempo agotado antes de cambiar límites. Selenium muestra lo observado por el navegador, pero no explica por qué un servicio tomó su decisión.

Use sondeo acotado y un final claro. Si una página se vuelve lenta, confirme primero que la señal sigue representando el comportamiento visible. Aumentar el límite puede ocultar un evento de disponibilidad roto.

Asigne propiedad a perfiles y controladores

El controlador, el binario, el directorio de perfil y el fixture forman una unidad de compatibilidad. Registre esas entradas, asigne un directorio a cada sesión concurrente y cierre el controlador mediante su ciclo normal.

BotBrowser admite compatibilidad con ChromeDriver e integración con Selenium Grid en flujos autorizados. Eso no garantiza compatibilidad con toda versión de controlador, Grid, navegador o configuración, ni reemplaza la política de esperas y limpieza. La guía de perfiles con Selenium y la validación de interacción amplían los límites de almacenamiento.

En comprobaciones entre máquinas compare un resultado acordado, no tiempos incidentales idénticos, y el registro de divergencia entre nodos de Grid separa una diferencia de tiempos de una diferencia de valores antes de tratar cualquiera como causa. Sistema operativo, controlador, gráficos y red cambian el momento de llegada de una condición. Registre la combinación probada y repita cuando cambie una entrada.

Convierta las decisiones en pruebas mantenibles

Un recorrido estable forma una cadena: estado sintético declarado, control visible, estado operable, una acción y el siguiente resultado. Nombre las fronteras de navegación, ventana, marco y limpieza para que el primer fallo conserve su contexto.

Revise las esperas cuando cambia la interfaz. Una etiqueta accesible nueva, una fase de carga o un estado en línea modifican localizador, predicado, aserción y mensaje juntos. Mantenga explícitos los caminos de rechazo y permisos.

Antes de integrar un cambio use un perfil limpio y propio con las versiones registradas. Confirme el cierre en éxito y fallo, limite los artefactos a datos sintéticos y clasifique una dependencia ausente como problema de entorno o aplicación.

Una forma práctica de hacer revisable esa cadena es una tabla de estados en el diseño del test. Para un recorrido de inicio de sesión se queda en estas filas:

PasoTermina cuandoEvidencia si falla
abrir formulariopresence_of_element_located sobre el campo de correofragmento del código de la página
enviarelement_to_be_clickable sobre el botón de envíoURL actual y captura de pantalla
resultadovisibility_of_element_located sobre el encabezado de cuenta o la región de acceso denegadoel localizador ausente y su estado
cerrar sesióndriver.quit() vuelve sin lanzarel id de sesión que quedó atrás

La tabla no es una segunda implementación de la prueba. Es un acuerdo compacto entre quien mantiene la página y quien mantiene el test sobre qué es observable y quién diagnostica una discrepancia.

La desaparición de un indicador solo es una señal válida si la aplicación documenta que el siguiente control ya es seguro. Mantenga el sondeo sin efectos laterales: no pulse, envíe ni modifique almacenamiento mientras decide si continúa. En Playwright, comprobar por separado la respuesta y la revisión visible permite saber cuál de las dos señales falta.

Use límites pequeños por frontera y conserve el presupuesto transcurrido en el informe. Si el entorno aprobado es más lento, ajuste su configuración sin borrar el nombre del contrato. Una repetición permitida debe marcarse como tal y comparar observaciones.

Ensaye el camino de fallo con un fixture que retenga una señal. El resultado esperado es un tiempo agotado acotado y descriptivo, nunca una prueba verde que omite su aserción. La confianza nace de condiciones visibles, fallos concretos y limpieza repetible.

BotBrowser proporciona compatibilidad con ChromeDriver y Selenium Grid para flujos autorizados, pero no reemplaza la política de esperas, el contrato de preparación de la aplicación ni la limpieza del perfil.

El registro de revisión conserva contrato, presupuesto, propietario y evidencia en una nota breve para que el cambio de interfaz tenga un responsable claro.

Fuentes

Conclusión práctica

Entrega la tabla de estados junto a la prueba: una fila por paso, el predicado que lo cierra y el artefacto que se recoge cuando falla. Mantén los presupuestos visibles y separados, de modo que una espera de dos segundos para un localizador, una de quince segundos para el render y una de treinta para el relevo remoto nunca se fundan en un número global. Ensaya el camino de fallo con una fixture que retiene una señal de preparación y comprueba que el tiempo de espera nombre esa señal en lugar de colgarse. Cuando cambie la interfaz, actualiza localizador, predicado, aserción y mensaje de fallo en la misma edición.

#Selenium#WebDriver#Esperas Explícitas#Estabilidad De Pruebas#Pruebas De Navegador

Este artículo forma parte de la guía: Primeros pasos con automatización de navegador: mapa inicial

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.