静的アセットの配信やユーザーアップロードの検証において、ファイル名の拡張子だけに依存すると本番環境でのバグに直結します。コンテンツ生成パイプラインがWebPやAVIF画像を従来の.jpg拡張子のまま保存してしまったり、設定不備のあるS3アップロードがapplication/octet-streamやtext/plainにフォールバックしたりするケースは珍しくありません。
ローカルファイルproduct-hero.jpgをインスペクターにドロップすると、ツールはメモリ上で先頭バイトを切り出し、バイナリ署名と拡張子のマッピングを比較します。
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
JPEGのStart-of-Imageマーカー(FF D8 FF)ではなく、0x00〜0x03バイトにRIFF、0x08〜0x0BバイトにWEBPが含まれています。インスペクターは即座に不一致を検出し、正しいHTTPメタデータを生成します。
{
"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"
]
}
ESモジュール(.mjsや.js)のようにバイナリのマジック署名を持たないテキストベースのアセットについては、ディレクトリを検索することで、Nginx、Cloudflare Workers、S3メタデータにそのまま使えるRFC 9239準拠のヘッダーブロックが出力されます。
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff