Se fier uniquement aux extensions de noms de fichiers lors de la distribution de ressources statiques ou de la validation de fichiers téléversés par les utilisateurs provoque fréquemment des bugs en production. Les pipelines de contenu enregistrent régulièrement des images WebP ou AVIF avec une extension héritée .jpg, et les envois S3 mal configurés retombent souvent sur application/octet-stream ou text/plain.
Lorsque vous déposez un fichier local nommé product-hero.jpg dans l'inspecteur, l'outil découpe les premiers octets en mémoire et compare la signature binaire avec le mappage de l'extension :
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
Au lieu du marqueur de début d'image JPEG (FF D8 FF), les octets 0x00–0x03 contiennent RIFF et les octets 0x08–0x0B contiennent WEBP. L'inspecteur signale immédiatement l'incohérence et génère les métadonnées HTTP exactes :
{
"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"
]
}
Pour les ressources textuelles dépourvues de signatures binaires magiques — telles que les modules ES (.mjs ou .js) — la recherche dans le répertoire produit le bloc d'en-têtes exact conforme à la RFC 9239, prêt pour Nginx, Cloudflare Workers ou les métadonnées S3 :
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff