Cuando trabajas con httpYac en tu pipeline de integración continua, todo va sobre ruedas: las pruebas pasan, el equipo lo sabe, pero en cuanto alguien pide '¿podemos ver un informe?', te das cuenta de que mirar la salida de la terminal no es suficiente. Ahí entra en juego httpyac-plugin-reporter-html, una herramienta que transforma los resultados de tus pruebas en un informe HTML completo, autónomo y sin dependencias externas.
Si aún no conoces httpYac, imagínalo como el hermano de línea de comandos de la extensión REST Client de VS Code. Escribes tus llamadas API en archivos .http — método, URL, cabeceras, cuerpo, aserciones — y las ejecutas desde el terminal o en tus pipelines de CI/CD. Es rápido, scriptable y se integra de forma impecable con cualquier flujo de trabajo. Pero le faltaba una pieza: un informe legible y compartible.
Esa pieza es httpyac-plugin-reporter-html. Este plugin se conecta al ciclo de vida de httpYac y genera un único archivo HTML independiente después de que tus pruebas finalicen. Ábrelo en cualquier navegador — sin servidor, sin internet, sin dependencias. Todo — CSS, JavaScript, datos de prueba — está incrustado en el propio archivo.
La instalación es inmediata: npm install --save-dev httpyac-plugin-reporter-html. httpYac descubre automáticamente el plugin, sin configuración extra. Luego ejecutas tus pruebas con httpyac send **/*.http y el archivo report.html aparece en la raíz de tu proyecto. Si necesitas personalizar el título o la ruta de salida, puedes añadir un bloque htmlReporter en tu .httpyac.config.js.
¿Qué muestra realmente el informe? No es un simple muro de marcas verdes. Cada región de prueba obtiene una tarjeta con todo lo necesario: una barra de héroe con 9 estadísticas — peticiones, pasadas, fallidas, omitidas, duración más totales a nivel de prueba — tarjetas con código de color (verde para 2xx, ámbar para 3xx, naranja para 4xx, rojo para 5xx), paneles plegables para cabeceras y cuerpos de petición y respuesta (con JSON formateado), insignias de aserción que muestran el mensaje de error cuando fallan, metadatos por petición (archivo fuente, línea, timestamp, títulos y descripciones de tu archivo .http), y un filtro de búsqueda en el lado del cliente que permite filtrar por resultado o clase de estado HTTP, sin recargar la página. Las regiones no HTTP (AMQP, MQTT, gRPC, WebSocket) se omiten automáticamente, manteniendo el informe centrado en las peticiones HTTP.
Detrás de escena, el plugin se engancha en el evento responseLogging del ciclo de vida de httpYac, no en onResponse. Esta distinción es crucial: onResponse se dispara justo después de recibir la respuesta HTTP, antes de que se ejecuten las aserciones. Si recogiésemos resultados ahí, obtendríamos datos de prueba vacíos. responseLogging se dispara después de que el bucle de ejecución completo haya terminado, incluyendo todas las aserciones. Para entonces, cada aserción ha sido evaluada y el estado completo (SUCCESS, FAILED, ERROR, SKIPPED) está disponible en la región. Además, el informe se escribe progresivamente después de cada petición, de modo que incluso si una ejecución se interrumpe a medio camino, obtienes un informe parcial con lo que se haya completado.
Este enfoque es ideal para entornos de integración continua. Por ejemplo, en GitHub Actions puedes subir el informe como artefacto, incluso si las pruebas fallan, usando if: always(). Así todo el equipo puede descargar el HTML y revisar los resultados sin depender de una infraestructura externa.
En Q2BSTUDIO, como empresa especializada en desarrollo de aplicaciones a medida, sabemos que la calidad del software se sostiene sobre pruebas automatizadas sólidas. Por eso incorporamos herramientas como httpYac y su plugin de informes en nuestros flujos de trabajo. Nuestros clientes que migran a cloud AWS/Azure suelen necesitar reportes compartibles que no requieran infraestructura adicional, y este plugin encaja perfectamente. Además, en proyectos donde integramos IA, ciberseguridad o BI/Power BI, tener un informe claro de las pruebas de API acelera la detección de regresiones y mejora la colaboración entre equipos técnicos y de negocio.
La simplicidad del plugin no le resta potencia. Con opciones de configuración como el título del informe y la ruta de salida, se adapta a cualquier proyecto. Y si necesitas funcionalidades adicionales — exportación a JSON, múltiples formatos de salida, integración con Slack — el proyecto es abierto a contribuciones en GitHub.
En definitiva, httpyac-plugin-reporter-html resuelve un problema real: cómo compartir resultados de pruebas de API de forma elegante, sin depender de servicios externos y con una experiencia de usuario que cualquier miembro del equipo puede apreciar. Dale una oportunidad, pruébalo en tu pipeline y descubre cómo un informe bien diseñado puede mejorar la comunicación en tu equipo de desarrollo.
