Affidarsi esclusivamente alle estensioni dei nomi file quando si servono risorse statiche o si convalidano gli upload degli utenti causa frequentemente bug in produzione. Le pipeline di contenuti salvano regolarmente immagini WebP o AVIF con un'estensione legacy .jpg e gli upload S3 configurati in modo errato ripiegano spesso su application/octet-stream o text/plain.
Quando trascini un file locale chiamato product-hero.jpg nell'ispettore, lo strumento estrae i byte iniziali in memoria e confronta la firma binaria con la mappatura dell'estensione:
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
Invece del marcatore Start-of-Image JPEG (FF D8 FF), i byte 0x00–0x03 contengono RIFF e i byte 0x08–0x0B contengono WEBP. L'ispettore segnala immediatamente la discrepanza e genera i metadati HTTP accurati:
{
"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"
]
}
Per le risorse testuali prive di firme binarie magic-byte—come i moduli ES (.mjs o .js)—la ricerca nella directory restituisce l'esatto blocco di header conforme a RFC 9239, pronto per Nginx, Cloudflare Workers o i metadati S3:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff