Cómo ver un informe

Un informe de pruebas generado con Allure Report es básicamente un pequeño sitio web en HTML destinado a ser visto en un navegador web. Esta página describe cómo abrir y ver un informe una vez que lo hayas generado o recibido de un compañero.

TIP

Cuando sea posible, recomendamos configurar un plugin de integración de CI de manera que el informe de prueba esté disponible en línea sin necesidad de descargarlo.

Abrir un solo archivo HTML

Si tú (o otra persona responsable de generar los informes de prueba) usas el modo de un solo archivo (la opción --single-file), ¡buenas noticias! Este informe es el más fácil de ver: solo abre el archivo HTML en tu navegador web preferido, y eso es todo.

Considera cambiar al modo de un solo archivo si aún no lo has hecho, para que abrir los informes de prueba sea tan fácil cada vez.

Sin embargo, podría haber razones para no hacer esto, especialmente para evitar posibles problemas al navegar en proyectos muy grandes (muchos resultados de pruebas, toneladas de archivos adjuntos). En tal caso, sigue leyendo a continuación.

Iniciar un servidor web local

Por defecto, un informe de prueba no es un solo archivo, sino más bien un directorio que contiene varios archivos (HTML, JSON y otros tipos), a veces distribuidos como un archivo ZIP. El método más confiable para abrir este informe es usar el comando allure open en la terminal.

1. Si recibiste el informe de prueba en un archivo ZIP, descomprime todo su contenido en un directorio de tu dispositivo.

2. Ejecuta el comando allure open, proporcionándole la ruta al directorio. Por ejemplo:

   allure open /home/user/myproject/build/allure-report

   El comando inicia un servidor web local configurado para mostrar el contenido del directorio del informe. Luego, el comando abre automáticamente la página principal del informe en un navegador web. Por defecto, el servidor web funciona en una dirección IP local (como 127.0.1.1) y un puerto generado aleatoriamente. Puedes cambiar este comportamiento con los argumentos --host y --port.

3. Al terminar de ver el informe, puedes detener el servidor presionando Ctrl+C en la ventana de la terminal.

Abrir un directorio local en navegador web

Google Chrome

WARNING

Este método no se recomienda, ya que implica configurar parámetros que hacen que Google Chrome sea vulnerable a cierto tipo de scripts maliciosos. Si eliges usar este método, asegúrate de cerrar todas las pestañas con contenido en el que no confíes completamente y no volver a abrirlas hasta que reviertas la configuración.

Para poder abrir correctamente los informes de prueba desde archivos locales en Google Chrome, necesitas iniciar el navegador con un argumento de línea de comandos específico. Esto afectará todos los sitios web abiertos en Google Chrome hasta que lo reinicies nuevamente sin ese argumento de línea de comandos.

1. Si recibiste el informe de prueba en un archivo ZIP, descomprime todo su contenido en un directorio de tu dispositivo.

2. Si Google Chrome está en ejecución, abre el menú del navegador y selecciona Salir para cerrar todas sus ventanas.

   Esto es necesario porque, de lo contrario, la opción de línea de comandos en el siguiente paso no afectará al navegador.

3. Abre una terminal y ejecuta Google Chrome, especificando la opción --allow-file-access-from-files y la ruta al archivo index.html de tu informe de prueba. Por ejemplo:

   Windows

   %ProgramFiles%\Google\Chrome\Application\chrome.exe -allow-file-access-from-files /home/user/myproject/build/allure-report/index.html

   MacOS

   open -a "Google Chrome" --args --allow-file-access-from-files /Users/user/myproject/build/allure-report/index.html

   Linux

   google-chrome --allow-file-access-from-files /home/user/myproject/build/allure-report/index.html

4. Al terminar de ver el informe de prueba, abre el menú del navegador y selecciona Salir para cerrar todas sus ventanas.

   Esto es necesario para que el navegador olvide la configuración temporal antes del próximo lanzamiento.

Mozilla Firefox

WARNING

Este método no se recomienda, ya que implica configurar parámetros que hacen que Mozilla Firefox sea vulnerable a cierto tipo de scripts maliciosos. Si eliges usar este método, asegúrate de cerrar todas las pestañas con contenido en el que no confíes completamente y no volver a abrirlas hasta que reviertas la configuración.

Para poder abrir correctamente los informes de prueba desde archivos locales en Mozilla Firefox, necesitas cambiar una cierta preferencia global. Esto afectará a todos los sitios web abiertos en Mozilla Firefox hasta que cambies la preferencia de nuevo.

1. Si recibiste el informe de prueba en un archivo ZIP, descomprime todo su contenido en un directorio de tu dispositivo.

2. En Mozilla Firefox, abre una nueva pestaña y ve a la dirección: about:config.

3. Si aparece una advertencia Proceder con precaución, haz clic en Aceptar el riesgo y continuar.

4. En el cuadro de busqueda, ingresa: security.fileuri.strict_origin_policy.

   La preferencia con ese nombre debería aparecer en la página.

5. Si la preferencia está establecida en true, haz doble clic sobre el valor para alternarlo.

   Asegúrate de que la preferencia ahora esté establecida en false.

6. En un explorador de archivos, navega hasta el directorio de tu informe de prueba y abre su archivo index.html en Mozilla Firefox.

7. Al terminar de ver el informe de prueba, regresa a la pestaña about:config y haz doble clic sobre el valor nuevamente.

   Asegúrate de que la preferencia ahora esté establecida en true.