Parser de Cache-Control

O Cache-Control é uma lista de diretivas separadas por vírgula, e boa parte da dificuldade vem de nomes que sugerem o oposto do que fazem. Cole o cabeçalho e a página explica cada diretiva encontrada, separando as que valem para o cache do navegador das que valem só para cache compartilhado.

O nome mais enganoso é no-cache, que não proíbe armazenar: ele permite guardar e exige revalidar antes de reutilizar. Quem quer proibir de fato usa no-store. A confusão entre os dois produz os dois erros clássicos — dado sensível ficando em cache de disco, e conteúdo estático sendo revalidado a cada visita sem necessidade.

A dupla que resolve a maior parte dos casos é max-age com immutable para arquivo versionado por hash no nome, e no-store para resposta com dado pessoal. No meio ficam as diretivas de tolerância — stale-while-revalidate, que serve conteúdo vencido enquanto atualiza em segundo plano, e stale-if-error, que serve vencido quando a origem falha. As duas trocam frescor por disponibilidade, e é uma troca que costuma valer.