警告

已棄用:此功能不再推薦使用。儘管某些瀏覽器可能仍然支援它,但它可能已從相關的 Web 標準中移除,或者正在被移除,或者僅出於相容性目的而保留。避免使用它,並儘可能更新現有程式碼;請參閱此頁面底部的相容性表格,以指導您的決策。請注意,此功能可能隨時停止工作。

注意:此標頭已棄用,因為它沒有被廣泛生成或公開給使用者(請參閱RFC9111)。某些資訊可以從其他標頭(例如Age)推斷出來。

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 表格僅在瀏覽器中載入

另請參閱