Confiar apenas nas extensões de nome de arquivo ao servir ativos estáticos ou validar uploads de usuários frequentemente causa bugs em produção. Pipelines de conteúdo costumam salvar imagens WebP ou AVIF com uma extensão legada .jpg, e uploads mal configurados para o S3 frequentemente caem no padrão application/octet-stream ou text/plain.
Quando você solta um arquivo local chamado product-hero.jpg no inspetor, a ferramenta fatia os bytes iniciais na memória e compara a assinatura binária com o mapeamento da extensão:
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
Em vez do marcador de início de imagem JPEG (FF D8 FF), os bytes 0x00–0x03 contêm RIFF e os bytes 0x08–0x0B contêm WEBP. O inspetor sinaliza a divergência imediatamente e gera os metadados HTTP corretos:
{
"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 ativos baseados em texto sem assinaturas binárias mágicas — como módulos ES (.mjs ou .js) —, pesquisar no diretório gera o bloco de cabeçalhos exato compatível com a RFC 9239, pronto para Nginx, Cloudflare Workers ou metadados do S3:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff