HAR Guard CI

Automatiza comparaciones HAR en tu pipeline de CI

⚡ HAR Guard CI: captura y compara archivos HAR para detectar regresiones de rendimiento en tu aplicación web, directamente desde tu pipeline de CI. Mantén cada despliegue honesto con verificaciones reproducibles y basadas en datos.

Ver el paquete har-guard-ci

npm install --save-dev har-guard-ci

Lo que obtienes

Guardas de rendimiento deterministas para cada rama.
Informes en Markdown o JSON listos para los logs de CI y comentarios en PR.
Scripts npm listos que conviven con tus suites E2E existentes.

Rieles de seguridad de rendimiento nativos de CI

Conecta HAR Guard directamente en tu pipeline para detectar regresiones antes de que lleguen a producción.

Retroalimentación rápida en cada deploy

Captura HAR nuevos bajo demanda y compáralos con una base conocida en cuestión de minutos.

Funciona con tus herramientas actuales

Usa Playwright para registrar el tráfico, ejecuta comparaciones en Node y publica informes Markdown enriquecidos en tus PR.

Comandos esenciales

capture

Registra un HAR para cualquier URL pública o autenticada usando Playwright y escribe el archivo en disco.

npx har-guard capture https://example.com artifacts/example.har

compare

Inspecciona dos archivos HAR y falla cuando se exceden los umbrales de tiempo o de peso de payload.

npx har-guard compare har/baseline.har har/candidate.har --reporter markdown

Instalación

Instala el paquete junto a tus herramientas de extremo a extremo. Playwright solo es necesario cuando quieras capturar nuevos archivos HAR.

npm install --save-dev har-guard-cinpm install --save-dev playwright

Playwright solo es necesario cuando uses el comando capture.

Capturar un HAR

Instala Playwright y ejecuta el comando de captura con la URL que quieras medir y la ruta de salida del archivo .har. El comando abre Chromium, espera a que la página termine de cargar y escribe el archivo HAR en la ruta indicada.

npx har-guard capture https://example.com artifacts/example.har

Confirma el archivo HAR resultante en tu repositorio para que los cambios futuros puedan compararse contra él.

Comparar archivos HAR

Usa el comando compare para detectar regresiones entre un HAR base y uno candidato. Si se superan los umbrales o aparecen solicitudes nuevas, el comando termina con un código distinto de cero para que falle el trabajo de CI.

npx har-guard compare har/baseline.har har/candidate.har --reporter markdown

Ejecución en CI

Conecta HAR Guard en tu flujo de trabajo de GitHub Actions (o cualquier CI que pueda ejecutar Node) para validar cada pull request antes de hacer merge.

name: HAR Guard

on:
  pull_request:

jobs:
  compare:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - name: Compare HAR files
        run: npx har-guard compare har/baseline.har har/candidate.har --reporter markdown

Si se encuentran regresiones, el paso termina con código 1 y el flujo de trabajo falla, manteniendo intacto el presupuesto de rendimiento.

Explora el repositorio de demo

Un repositorio de ejemplo completo —incluyendo archivos HAR base y candidato, scripts npm y un flujo de trabajo reutilizable de GitHub Actions— está disponible en examples/demo-repo. Úsalo como referencia para integrar HAR Guard en tu propio proyecto.

Lee la documentación en npm