Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
Warning
Nota:O cabeçalhoWarning será depreciado em breve; vejaWarning (https://github.com/httpwg/http-core/issues/139) eWarning: header & stale-while-revalidate (https://github.com/whatwg/fetch/issues/913) para mais detalhes.
O cabeçalho geral HTTPWarning contém informação sobre possíveis problemas com o status da mensagem. Mais de um cabeçalhoWarning pode aparecer na resposta.
O cabeçalhoWarning 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
Warningser deletado de uma resposta guardada depois da validação.- Códigos de aviso
1xxdescrevem o frescor ou status de validação da resposta e será deletado por um cache depois da deleção. - Códigos de aviso
2xxdescrevem 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)
Oregistro 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 GMTWarning: 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 |