Warning
Nota: O cabeçalho Warning
será depreciado em breve; veja Warning (https://github.com/httpwg/http-core/issues/139) e Warning: header & stale-while-revalidate (https://github.com/whatwg/fetch/issues/913) para mais detalhes.
O cabeçalho geral HTTP Warning
contém informação sobre possíveis problemas com o status da mensagem. Mais de um cabeçalho Warning
pode aparecer na resposta.
O cabeçalho Warning
geralmente pode ser aplicado para qualquer mensagem, entretanto alguns códigos de aviso são específicos para caches e podem somente ser aplicados para mensagens de resposta.
Tipo de cabeçalhos | General header |
---|---|
Forbidden header name | não |
Sintaxe
Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]
Diretivas
- <warn-code>
- Um número de aviso de três dígitos. O primeiro dígito indica se é necessário o
Warning
ser deletado de uma resposta guardada depois da validação.- Códigos de aviso
1xx
descrevem o frescor ou status de validação da resposta e será deletado por um cache depois da deleção. -
Códigos de aviso
2xx
descrevem algum aspecto da representação que não é retificada por uma validação e não será deletado por uma cache depois da validação a não que a resposta completa seja enviada.
- Códigos de aviso
- <warn-agent>
-
O nome ou pseudônimo do servidor ou software adicionando o cabeçalho
Warning
(pode ser "-" quando o agente não é conhecido). - <warn-text>
- Texto consultivo descrevendo o erro.
- <warn-date>
- Opcional. Se mais de um cabeçalho
Warning
é enviado, inclui a data que corresponde com o cabeçalhoDate
.
Códigos de aviso (Warning)
O registro de Códigos de Aviso HTTP em iana.org define o espaço de nomes para códigos de aviso.
Código | Texto | Descrição |
---|---|---|
110 | Resposta está velha | A resposta provida pela cache está velha (o tempo de expiração já passou). |
111 | Revalidação falhou | Uma tentaiva de validar a resposta falhou, por causa da impossibilidade de alcançar o servidor. |
112 | Operação Desconectou | O cache desconectou do resto da rede. |
113 | Expiração Heurística | Enviado se a cache escolhe heuristicamente um tempo de vida fresco maior que 24 horas e a idade da resposta é maior que 24 horas. |
199 | Aviso diverso | Arbitrário, aviso não específico. |
214 | Transformação aplicada | Adicionado por um proxy se ele aplica qualquer transformação na representação, como mudar a codificação de conteúdo, tipo de media ou semelhante. |
299 | Aviso diverso persistente | O mesmo que 199, mas indicando um aviso persistente. |
Exemplos
Warning: 110 anderson/1.3.37 "Response is stale" Date: Wed, 21 Oct 2015 07:28:00 GMT Warning: 112 - "cache down" "Wed, 21 Oct 2015 07:28:00 GMT"
Especificações
Especificação | Título |
---|---|
RFC 7234, sessão 5.5: Warning | Hypertext Transfer Protocol (HTTP/1.1): Caching |
Compatibilidade de navegador
BCD tables only load in the browser
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.