Warning 標頭

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

注意: 該標頭已被棄用,因為它未被廣泛生成或呈現給使用者(參見 RFC9111)。某些資訊可以從其他標頭(例如 Age)推斷出來。

HTTP Warning 請求響應標頭包含有關訊息狀態可能出現問題的資訊。一個響應中可能會出現多個 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

瀏覽器相容性

另見