Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Giofelix/Proyecto-automatizacion-Empresa/llms.txt

Use this file to discover all available pages before exploring further.

automation-arqc utiliza dos sistemas de reporte de forma complementaria: Allure es el reporte principal, orientado a comunicar resultados a todo el equipo con historial, pasos BDD y metadatos de entorno; el reporte HTML de Playwright actúa como respaldo local, disponible instantáneamente sin necesidad de instalar dependencias adicionales. Ambos se generan en la misma ejecución y se pueden consultar de forma independiente.

​
Allure Reports

Allure es el reporte oficial del proyecto. Captura cada bloque given / when / then como un paso nombrado, registra variables de entorno (versión de Node y plataforma del SO) y organiza los tests por suite, módulo y resultado.

Generar y abrir

Genera un reporte nuevo desde los resultados de la última ejecución y lo abre en el navegador:
npm run report:generate
Esto ejecuta allure generate allure-results --clean && allure open. El flag --clean descarta el reporte anterior para que el nuevo refleje únicamente los resultados actuales.

Servir el reporte existente

Si ya generaste el reporte y solo quieres volver a abrirlo sin regenerarlo:
npm run report:serve
Esto ejecuta allure serve allure-results y sirve los resultados crudos directamente, sin necesitar un reporte previamente generado con allure generate.

​
En Jenkins

Cuando la suite termina en Jenkins, el pipeline genera el reporte Allure y lo publica automáticamente. Puedes acceder a él desde el menú lateral izquierdo de cada build, en el enlace “Allure Report”. El reporte queda asociado al build y es accesible de forma permanente mientras el build esté disponible en el servidor. Los datos que Allure registra automáticamente en cada ejecución incluyen:
  • Pasos del test derivados de los bloques given, when, then y and de gherkin-lite
  • Estado de cada paso (passed / failed / broken)
  • Información de entorno: versión de Node (process.version) y plataforma del SO (process.platform)
  • Historial de ejecuciones anteriores del mismo test (tendencia de flakiness)

​
Playwright HTML Report

El reporte HTML nativo de Playwright se genera en playwright-report/ durante cada ejecución y sirve como alternativa rápida cuando Allure no está disponible o no está instalado en la máquina: 
npm run report:pw
Este comando ejecuta npx playwright show-report, que levanta un servidor local y abre el reporte en el navegador. Desde este reporte puedes acceder directamente a los artefactos de fallo (trace, screenshot, video) con un solo clic.

​
Artefactos en fallo

playwright.config.js está configurado con retain-on-failure para los tres tipos de artefactos, lo que significa que solo se guardan cuando un test falla — no se acumula espacio en disco durante las ejecuciones verdes: 
trace: 'retain-on-failure',
screenshot: 'only-on-failure',
video: 'retain-on-failure',
Los artefactos se guardan en test-results/<nombre-test>/ con los siguientes formatos:

Trace

trace.zip — Grabación completa de la sesión del navegador: cada acción, cada mutación del DOM, cada petición de red y cada snapshot de la pantalla. Es el artefacto más completo para diagnosticar un fallo.

Screenshot

screenshot.png — Captura del estado visual de la pantalla exactamente en el momento en que el test falló. Útil para identificar problemas de UI o estados inesperados de la aplicación.

Video

video.webm — Video completo de la ejecución del test fallido. Permite ver la secuencia de acciones que llevaron al error, incluyendo animaciones y transiciones de Angular Material.

​
Inspeccionar un trace

Para abrir el Trace Viewer de Playwright con el archivo de un test fallido: 
npx playwright show-trace test-results/<nombre-test>/trace.zip
El Trace Viewer muestra una línea de tiempo interactiva con snapshots de la pantalla en cada paso, el árbol del DOM, los logs de consola y las peticiones de red. Puedes navegar al frame exacto en que ocurrió el fallo y explorar el estado completo del navegador en ese instante.

​
En Jenkins

Además del reporte Allure publicado en el menú del build, el pipeline archiva dos carpetas como artefactos descargables:
  • playwright-report/ — El reporte HTML completo de Playwright.
  • test-results/ — Todos los artefactos de fallo (traces, screenshots y videos) organizados por test.
Para descargarlos, accede al build en Jenkins y ve a la sección “Build Artifacts” en el resumen del build. Puedes descargar los artefactos individualmente o como un ZIP completo de la carpeta.
Durante la depuración de un fallo intermitente o difícil de reproducir, puedes activar la captura completa de artefactos para todos los tests (no solo los fallidos) cambiando temporalmente la configuración en playwright.config.js:
// Cambiar de retain-on-failure a on para capturar siempre
trace: 'on',
screenshot: 'on',
video: 'on',
Recuerda revertir estos valores antes de hacer commit — la captura continua incrementa significativamente el tiempo de ejecución y el espacio en disco consumido por los artefactos.

Build docs developers (and LLMs) love

Get started for freeTalk to us