警告
已弃用:此功能不再推荐使用。尽管某些浏览器可能仍然支持它,但它可能已从相关的 Web 标准中移除,或者正在被移除,或者仅出于兼容性目的而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的兼容性表格,以指导您的决策。请注意,此功能可能随时停止工作。
Warning
HTTP 标头包含有关消息状态可能存在的问题的信息。响应中可能出现多个 Warning
标头。
通常,Warning
标头字段可以应用于任何消息。但是,某些警告代码特定于缓存,并且只能应用于响应消息。
语法
http
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 | 响应已过期 | 缓存提供的响应已过期(为响应设置的过期时间已过)。 |
111 | 重新验证失败 | 由于无法访问服务器,导致重新验证过期的响应失败。 |
112 | 断开连接操作 | 缓存有意与网络的其余部分断开连接。 |
113 | 启发式过期 | 缓存启发式地选择了大于 24 小时的新鲜度生存期,并且响应的年龄大于 24 小时。 |
199 | 其他警告 | 应向用户呈现或记录的任意信息。 |
214 | 应用转换 | 如果代理对表示形式应用任何转换(例如更改内容编码、媒体类型等),则由代理添加。 |
299 | 其他持久性警告 | 应向用户呈现或记录的任意信息。此警告代码类似于警告代码 199,并且另外指示持久性警告。 |
示例
http
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"
规范
规范 |
---|
HTTP 缓存 # field.warning |
浏览器兼容性
BCD 表格仅在浏览器中加载