ETag

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 HTTP provê no cabeçalho (header) da resposta (response), a ETag que é um identificador para uma versão específica de um recurso. A ETag permite que o cache torne-se mais eficiente e preserve o tráfego de dados (largura de banda), assim um web server não precisa reenviar uma resposta com todos os dados que não tiveram nenhuma mudança em seu conteúdo. Além disso, as ETags ajudam a impedir que atualizações simultâneas de um recurso sejam feitas por outros. Veja sobre ("mid-air collisions").

Se o recurso numa URL sofre mudança, a Etag assume um novo valor que deve ser gerado pelo Web Server. Uma comparação entre elas podem determinar se as duas representações do recurso são iguais. Etags são similares às nossas impressões digitais, e por isso também podem ser usadas por alguns servidores como um forma de rastreamento. Elas podem ser configuradas a fim de que possam ser persistidas idenfinidamente por um servidor de rastreamento.

Header type Response header
Forbidden header name no

Sintaxe

ETag: W/"<etag_value>"
ETag: "<etag_value>"

Diretivas

W/ Optional

'W/' (case-sensitive) Indica que um validador fraco está sendo usado (veja mais em weak validator). Etags Fracas são fáceis de serem geradas, mas possuem a desvantagem de serem menos usadas para comparações. Validadores Fortes são ideais para comparações mas podem ser muito difíceis de serem gerados de uma forma eficaz. Os valores de uma Etag Fraca para duas representações de um único recurso podem ser equivalentes semanticamente, contudo não são idênticas em byte-for-byte. Isto significa que etags fracas impedem o cache efetivo quando requisições dentro de um intervalo de bytes são realizadas (veja mais em byte range requests ), ao passo que etags fortes permitem que um intervalo de requisições aindam possam ser preservadas no cache.

"<etag_value>"

Tag na Entidade que possui valor único o qual está representando o recurso requisitado. O valor será do tipo string com caracteres em ASCII que será exibido dentro de aspas duplas, como pode se vê ao lado "675af34563dc-tr34". O método por qual o valor da ETag foi gerado não está especificado. Frequentemente, uma hash do conteúdo, uma hash da última modificação ou somente um número de revisão é usado. Por exemplo o MDN usa uma hash hexadecimal para o conteúdo do artigo da wiki.

Exemplos

ETag: "33a64df551425fcc55e4d42a148795d9f25f89d4"
ETag: W/"0815"

Fugindo de ediçoes simultâneas

Com a ajuda da ETag e o cabeçalho If-Match (headers), você pode detectar choque de edições simultânes.

Por exemplo, quando editamos o MDN, o conteúdo atual da wiki é criptografado e colocado dentro de uma Etag da resposta (response).

ETag: "33a64df551425fcc55e4d42a148795d9f25f89d4"

Quando salvamos as mudanças para a página da wiki, (posting data), a requisição POST conterá o cabeçalho If-Match contendo o valor da ETag para checar a atualização.

If-Match: "33a64df551425fcc55e4d42a148795d9f25f89d4"

Se o hash não for compatível, isto significa que o documento foi editado durante determinado intervalo e uma resposta com o status 412 Precondition Failed será enviada ao cliente.

Armazenando recursos sem alterações

Outro uso típico de cabeçalho (header) com a ETag é para guardar recursos que não foram alterados. Se um usuário visitar um recurso dado por uma URL de novo, (é necessaíro ter a ETag configurada), e ele deseja saber se está obsoleto (stale) (ou antigo para ser considerado como utilizável), o cliente enviará o valor da sua ETag por meio de um atributo no cabeçalho If-None-Match, veja o exemplo abaixo:

If-None-Match: "33a64df551425fcc55e4d42a148795d9f25f89d4"

O servidor irá comparar a ETag do cliente (enviada com If-None-Match) com a versão da ETag disponível para o recurso, e se ambos os valores forem compatíveis (isto é, o recurso não foi modificado), o servidor enviará de volta a resposta com status 304 Sem Modificação (Not modified), porém sem um body, comunicando ao cliente que a versão guardada na resposta ainda está atualizada (ou boa para uso, fresh).

Especificações

Especificação Título
RFC 7232, sessão 2.3: ETag Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também