Pruebas de regresión visual en Nexus StudioQA.
Las pruebas de regresión visual en Nexus StudioQA comparan una captura de pantalla de cada ejecución con una imagen de referencia que has aprobado. La primera ejecución con --visual establece la referencia. Las ejecuciones posteriores cuentan los píxeles que han cambiado, ignoran los bordes suavizados y guardan una imagen de diferencias cuando el cambio supera la tolerancia. De forma predeterminada, se registra la regresión, pero no hace fallar la prueba.
Por el equipo de Nexus StudioQA, Verdict System LLC.
Última actualización: .
Qué compara cada ejecución
Dos tipos de punto de control, cada uno con su propia tolerancia: la proporción de píxeles que pueden diferir antes de que el cambio se considere una regresión.
| Punto de control | Qué se captura | Tolerancia predeterminada |
|---|---|---|
| Página completa | La captura del área visible al finalizar la prueba, guardada con el nombre baseline. | 1.0% de los píxeles (NEXUS_VISUAL_THRESHOLD) |
| Elemento | Un elemento, definido dentro de la prueba con visualCheck(page, 'cart-total', page.locator('#cart-total')). | 0.1% de los píxeles (NEXUS_VISUAL_ELEMENT_THRESHOLD) |
Cómo se determina un cambio
Las referencias se guardan por navegador y plataforma
Se almacenan en
visual-baselines/<browser>@<platform>/dentro de la carpeta del proyecto, para poder incluirlas en el control de versiones junto con tu código. Una imagen de Windows nunca se compara con una de Linux, porque las fuentes y el suavizado de bordes difieren. Cada combinación de navegador y plataforma sin referencia crea la suya propia.Los bordes suavizados no se cuentan
Un píxel que solo ha cambiado porque se ha recalculado el suavizado de un borde se marca en ámbar en la imagen de diferencias y se excluye del recuento. Un píxel se considera modificado cuando un canal de color difiere en 10 o más, y NEXUS_VISUAL_PIXEL_TOLERANCE permite ajustar ese valor entre 0 y 255.
Se repiten las capturas hasta que se estabilizan
Se repite la captura hasta que dos consecutivas sean idénticas byte a byte, con un máximo de tres capturas. Si una página nunca se estabiliza, se informa de que es inestable en lugar de convertirla en referencia sin advertencia.
Las imágenes de distinto tamaño no se estiran
Las dos imágenes se comparan a su tamaño original en la región que comparten, alineadas en la esquina superior izquierda. El área que no se superpone se cuenta como diferente.
Una comprobación que no se ha ejecutado se considera fallida
Si la comparación no puede ejecutarse, por ejemplo porque falta una imagen o no está instalada la biblioteca nativa de imágenes, la prueba falla independientemente de la configuración del modo estricto. Una comprobación que no se ha realizado no se da por superada.
Los ajustes que importan
Todos están en la pantalla de regresión visual de Studio, con sus valores predeterminados a continuación.
| Ajuste | Predeterminado | Qué hace |
|---|---|---|
| Comparar píxeles en cada ejecución | Apagado | Activa la comparación en cada ejecución. --visual la activa para una sola ejecución. |
| Una regresión hace fallar la prueba | Apagado | Con NEXUS_VISUAL_STRICT=true, los píxeles desplazados que superan la tolerancia hacen fallar la prueba. Si está desactivado, la regresión se registra y la prueba conserva su veredicto. |
| Enmascarado en cada captura | Ninguno | Selectores CSS cuyos elementos se cubren en cada captura, como un reloj o un anuncio (NEXUS_VISUAL_MASK). |
| Carpetas de regresión conservadas | 10 | Carpetas más recientes que se conservan por prueba y punto de control (NEXUS_VISUAL_REGRESSION_RETAIN). |
Lo que revisas y apruebas
Cada regresión se guarda en visual-regression con sus propios archivos, y Studio los muestra en cuatro vistas: En paralelo, Deslizar, Diferencias y Parpadeo, junto a las ejecuciones anteriores del mismo punto de control.
| Archivo | Qué es |
|---|---|
baseline.png | La imagen aprobada. |
current.png | La imagen de esta ejecución. |
diff.png | Rojo para los píxeles modificados, ámbar para el suavizado de bordes ignorado, gris para los que no han cambiado. |
visual-report.md | Las cifras en texto sin formato. |
result.json | El mismo resultado en forma de datos. |
Lo que no puede decirte
Los píxeles no pueden distinguir un rediseño planificado de un error, por lo que una persona aprueba cada cambio: Aprobar este cambio en Studio sustituye la imagen de un punto de control, y nexus baseline --update <TC_ID> hace lo mismo desde la línea de comandos. Todo lo que cambie por sí solo, como un reloj, un anuncio o un avatar, debe enmascararse o seguirá haciendo que la comparación aparezca en rojo.
Preguntas frecuentes
¿Una regresión visual hace fallar mi prueba?
No de forma predeterminada. La regresión se registra y la prueba conserva su veredicto. Activa
NEXUS_VISUAL_STRICTy una regresión que supere la tolerancia hará fallar la prueba.¿Por qué hay una imagen de referencia por sistema operativo?
Una misma página se muestra con fuentes, suavizado de bordes y barras de desplazamiento ligeramente distintos en Windows, Linux y macOS. Compararlos entre sí indica un cambio que solo se debe al motor de renderizado, por lo que cada navegador y plataforma conserva su propia imagen de referencia.
¿Cómo evito que un reloj o un anuncio hagan fallar la comprobación?
Enmascáralo con un selector CSS en los ajustes visuales, o usa un punto de control de elemento en la parte de la página que te interesa. A un punto de control de elemento se le aplica una décima parte de la tolerancia de la página completa, por lo que es estricto sin que un anuncio en movimiento lo haga aparecer en rojo.
¿Dónde se guardan las imágenes de referencia?
En
visual-baselines, dentro de la carpeta de tu proyecto, no en la carpeta de evidencias, para que puedas incorporarlas al repositorio junto con el código. Las diferencias de regresión son resultados de la ejecución y se guardan envisual-regression, dentro de la carpeta de evidencias.
Ejecútalo en tu propia máquina.
Prueba gratis todas las funciones, en tus propios equipos. Sin tarjeta.