MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Warning

Warning 是一个通用消息首部,包含有当前消息状态可能存在的问题。在响应中可以出现多个 Warning 首部。

一般来说, Warning 首部可以应用于任何类型的消息。然而一部分警告码(warn-code)是为缓存代理服务器定制的,并且只可以应用在响应消息中。

Header type General header
Forbidden header name no

语法

Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]

指令

<warn-code>
三位数字警告码。第一位数字表示 Warning 信息在验证之后是否需要从已存储的响应中删除。
  • 1xx 警告码描述了关于当前响应的新鲜度或者验证状态的警告信息,并且将会在验证之后被缓存服务器删除。
  • 2xx 警告码描述了验证之后不会被修复的某些展现内容方面的警告信息,并且在验证之后不会被缓存服务器删除。

<warn-agent>

添加到 Warning 首部的服务器或者软件的名称或者伪名称(当代理不可知的时候可以用 "-" 代替)。

<warn-text>
用来描述错误信息的警告文本。
<warn-date>
可选。假如多个 Warning 被发送,那么需包含一个与 Date 首部相对应的日期字段。

警告码

由 iana.org 维护的 HTTP 警告码登记表规定了警告码的命名空间。

码值 文字描述 详细说明
110 Response is Stale 由缓存服务器提供的响应已过期(设置的失效时间已过)。
111 Revalidation Failed  由于无法访问服务器,响应验证失败。
112 Disconnected Operation 缓存服务器断开连接。
113 Heuristic Expiration 如果缓存服务器采用启发式方法,将缓存的有效时间设定为24小时,而在该响应的年龄超过24小时时发送。
199 Miscellaneous Warning 任意的、未明确指定的警告信息。
214 Transformation Applied 由代理服务器添加,如果它对返回的展现内容进行了任何转换,比如改变了内容编码、媒体类型等。
299 Miscellaneous Warning 与199类似,只不过指代的是持久化警告。

示例

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"

规范

Specification Title
RFC 7234, section 5.5: Warning Hypertext Transfer Protocol (HTTP/1.1): Caching

浏览器兼容性

FeatureChromeFirefoxEdgeInternet ExplorerOperaSafari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)(Yes)

相关内容

文档标签和贡献者

 此页面的贡献者: WayneCui
 最后编辑者: WayneCui,