Confiar únicamente en las extensiones de nombre de archivo al servir recursos estáticos o validar subidas de usuarios provoca errores frecuentes en producción. Los pipelines de contenido suelen guardar imágenes WebP o AVIF con una extensión heredada .jpg, y las subidas mal configuradas a S3 a menudo recurren por defecto a application/octet-stream o text/plain.
Cuando arrastras un archivo local llamado product-hero.jpg al inspector, la herramienta extrae los primeros bytes en memoria y compara la firma binaria con el mapeo de la extensión:
Filename: product-hero.jpg
Header Hex (0x00): 52 49 46 46 24 A1 01 00 57 45 42 50 56 50 38 58
Header ASCII: R I F F $ . . . W E B P V P 8 X
En lugar del marcador de inicio de imagen JPEG (FF D8 FF), los bytes 0x00–0x03 contienen RIFF y los bytes 0x08–0x0B contienen WEBP. El inspector señala la discrepancia de inmediato y genera los metadatos HTTP precisos:
{
"fileName": "product-hero.jpg",
"claimedExtension": ".jpg",
"claimedMimeType": "image/jpeg",
"detectedMagicHex": "52 49 46 46 ?? ?? ?? ?? 57 45 42 50",
"detectedMimeType": "image/webp",
"extensionMismatch": true,
"charsetRequired": false,
"compressible": false,
"recommendedHeaders": [
"Content-Type: image/webp",
"X-Content-Type-Options: nosniff"
]
}
Para recursos basados en texto sin firmas binarias mágicas —como los módulos ES (.mjs o .js)—, la búsqueda en el directorio genera el bloque de cabeceras exacto compatible con el RFC 9239, listo para Nginx, Cloudflare Workers o metadatos de S3:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff