Vary

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O cabeçalho de resposta HTTP Vary determina como corresponder futuros cabeçalhos de requisição para decidir se uma resposta cacheada pode ser usada ao invés de solicitar uma nova do servidor de origem. Ele é usado pelo servidor para indicar quais cabeçalhos ele utilizou quando selecionando a representação do recurso em um algoritmo de negociação de conteúdo.

O cabeçalho Vary deve ser colocado em uma resposta 304 Not Modified exatamente como seria colocado em uma resposta 200 OK equivalente.

Tipo de cabeçalho Response header
Forbidden header name não

Sintaxe

Vary: *
Vary: <header-name>, <header-name>, ...

Diretivas

*

Cada requisição para a URL é supostamente tratada como uma requisição única e incacheavél. Um jeito melhor de indicar isso é usar Cache-Control: no-store, que é mais limpo para se ler e também sinaliza que o objeto não deve ser guardado nunca.

<header-name>

Uma lista separada por vírgula de nomes de cabeçalhos para levar em conta quando for decidir se uma resposta cacheada pode ser usada.

Exemplos

Servimento dinâmico

Quando utilizando o cabeçalho Vary: User-Agent, servidores de cacheamento devem considerar o agente de usuário quando estiverem decidindo se irão servir a página do cache. Por exemplo, se você está servindo conteúdo diferente para usuários móveis, ele pode ajudar você a evitar que um cache possa erroneamente servir uma versão desktop do seu site, para os usuários móveis. Ele pode ajudar o Google e outros motores de busca a descobrir a versão móvel da página, e talvez possa dizer a eles que não existe intenção de Cloaking.

Vary: User-Agent

Especificações

Especificação Título
RFC 7231, sessão 7.1.4: Vary Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Compatibilidade com navegadores

BCD tables only load in the browser

Notas de compatibilidade

Veja também