Poleganie wyłącznie na rozszerzeniach nazw plików podczas serwowania zasobów statycznych lub walidacji plików przesyłanych przez użytkowników często prowadzi do błędów produkcyjnych. Potoki przetwarzania treści rutynowo zapisują obrazy WebP lub AVIF ze starszym rozszerzeniem .jpg, a błędnie skonfigurowane operacje wysyłania do S3 często domyślnie ustawiają application/octet-stream lub text/plain.
Gdy upuścisz lokalny plik o nazwie product-hero.jpg do inspektora, narzędzie wycina początkowe bajty w pamięci i porównuje sygnaturę binarną z mapowaniem rozszerzenia:
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
Zamiast znacznika początku obrazu JPEG (FF D8 FF), bajty 0x00–0x03 zawierają RIFF, a bajty 0x08–0x0B zawierają WEBP. Inspektor natychmiast oznacza niezgodność i generuje prawidłowe metadane 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"
]
}
W przypadku zasobów tekstowych pozbawionych binarnych sygnatur magicznych — takich jak moduły ES (.mjs lub .js) — przeszukanie katalogu zwraca dokładny blok nagłówków zgodny z RFC 9239, gotowy do użycia w konfiguracji Nginx, Cloudflare Workers lub metadanych S3:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff