TEC-004 — Compresión de Respuestas
· 2 min de lectura
Implementación de la mejora TEC-004 (Compresión de Respuestas), dentro de 6.1 Rendimiento y Escalabilidad. Las respuestas de la API se comprimen con gzip o brotli según lo que pida el cliente, y se deja sin tocar lo que no conviene comprimir.
📋 Alcance
| RF | Entregable |
|---|---|
| RF-TEC-004-01 | Compresión gzip/brotli en las respuestas |
| RF-TEC-004-02 | Negociación del algoritmo según Accept-Encoding |
| RF-TEC-004-03 | Exclusión de recursos que no lo requieren |
⚙️ Cómo funciona
- Middleware propio sobre
node:zlib, montado enmain.tsconapp.use(...). Sin dependencias nuevas. - Negociación (RF-02): parsea
Accept-Encodingcon q-values y comodín*, prioriza brotli cuando ambos se aceptan por igual y añadeVary: Accept-Encoding.deflateno se soporta: quien solo aceptedeflaterecibe la respuesta sin comprimir. - Exclusiones (RF-03): lista blanca de tipos de texto (
json,xml,text/*,svg,+json/+xml); quedan fuera imágenes, video, audio, PDF, ZIP, XLSX,octet-stream, fuentes, streams SSE,204/206/304,HEAD,Cache-Control: no-transform, respuestas ya comprimidas, cuerpos menores a 1 KB y cuerpos mayores al tope de buffer (5 MB). - Al comprimir se eliminan
Content-Length(Node lo recalcula conchunked) yETag.
🔧 Configuración
COMPRESSION_ENABLED=true
COMPRESSION_THRESHOLD=1024
COMPRESSION_GZIP_LEVEL=6
COMPRESSION_BROTLI_QUALITY=4
COMPRESSION_PREFERIR_BROTLI=true
Con un proxy inverso que ya comprima, COMPRESSION_ENABLED=false evita duplicar el trabajo.
✅ Verificación
- 35 pruebas nuevas (negociación, clasificación de tipos y middleware con servidor HTTP real).
- 580 pruebas en 57 suites, 0 fallos en la API;
tsc, ESLint ynpm run buildlimpios. - Script de integración contra la API real: gzip, brotli, q-values,
Vary,identityy exclusión de imagen.
Nota: no requiere cambios en el frontend; el navegador negocia Accept-Encoding solo.
