Configuración de Allure con Cypress y uso de plugins

Clase 24 de 29 • Curso de Cypress Avanzado

Resumen

¿Qué es Allure Report y cómo se instala con Cypress?

Ya has identificado que Cypress, aunque es una poderosa herramienta de pruebas automatizadas, no incluye por defecto todas las funciones que podrías necesitar. Uno de los reportadores más reconocidos del mercado, especialmente en pruebas, es Allure Report. Este, al ser open source, ofrece tanto funcionalidad avanzada como cero costo.

¿Cómo instalar Allure Report en Cypress?

La instalación de Allure Report en Cypress se lleva a cabo mediante un plugin específico desarrollado por la comunidad. Aquí te mostramos los pasos detallados:

Instalación del plugin: Abre tu terminal e instala el Cypress AluPlugin:
```
npm install @shelex/cypress-allure-plugin
```

Configuración del archivo: Una vez instalado, necesitamos modificar el archivo de configuración de Cypress. Importamos el AlurWriter y lo añadimos a la configuración:

const allureWriter = require('@shelex/cypress-allure-plugin/writer');

module.exports = (on, config) => {
  allureWriter(on, config);
  return config;
};

Carga del plugin: Luego, en la carpeta de soporte, usualmente en cypress/support/e2e.js, importa el plugin:
```
import '@shelex/cypress-allure-plugin';
```

¿Cómo ejecutamos el reportador?

Después de tener configurado el plugin, puedes generar los reportes mediante scripts personalizados en tu archivo package.json:

Definición del script:

{
  "scripts": {
    "test:allure": "cypress run --env allure=true"
  }
}

Comando de ejecución: Para ejecutar el reportador, utiliza el comando anteriormente definido:
```
npm run test:allure
```

Durante la ejecución, el sistema creará una carpeta allure-results que contiene los resultados en formato .json.

¿Cómo visualizar los reportes generados?

Para aprovechar al máximo los reportes generados y ver la visualización gráfica y detallada, asegúrate de tener instalado Allure en tu máquina. Este paso es crucial para transformar los resultados en un formato más legible y visualmente atractivo.

Instalación de Allure:
- En macOS: Ejecuta brew install allure.
- En Windows: Sigue las instrucciones proporcionadas en la documentación oficial de Allure.
Servidor local para visualizar: Ejecuta el siguiente comando para generar y visualizar el reporte en un servidor web:
```
allure serve
```

¿Qué ventajas ofrece Allure Report?

Una vez configurado y ejecutado, Allure proporciona un reporte gráfico con:

Gráficas detalladas: Permite ver el timeline, el comportamiento y los resultados de las pruebas de manera organizada.
Archivos multimedia: Capturas de pantalla en caso de errores y videos de grabación de la ejecución de tus pruebas.
Histórico de pruebas: Muestra cuántas veces se ha intentado una prueba, ofreciendo un seguimiento detallado.

Allure se perfila como una solución completa para cualquier equipo que desee mejoras en la visualización y análisis de resultados de pruebas automatizadas en Cypress. Además, su capacidad para generar documentos web fácilmente accesibles lo convierte en una herramienta invaluable para compartir resultados con stakeholders.

Allure combinado con Cypress puede transformar la manera en que realizas y reportas tus pruebas automatizadas. Como siempre, se recomienda revisar la documentación oficial para más detalles y configuraciones específicas. Sigue explorando, perfeccionando tus habilidades y prepárate para integrar más herramientas en tus flujos de trabajo. ¡El camino del aprendizaje nunca termina!