警告
已棄用:此功能不再推薦使用。儘管某些瀏覽器可能仍然支援它,但它可能已從相關的 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 表格僅在瀏覽器中載入