1. 給開發者的 Web 技術文件
  2. HTTP
  3. Reference
  4. Headers
  5. Accept-Encoding 標頭

此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

Accept-Encoding 標頭

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

HTTP Accept-Encoding 請求和回應標頭表示發送方可以理解的內容編碼（通常是壓縮演算法）。在請求中，伺服器使用內容協商從用戶端的編碼提案中選擇一個，並使用 Content-Encoding 回應標頭通知用戶端選擇。在回應中，它提供有關伺服器可以理解的內容編碼的訊息，以便在後續對資源的請求中使用該編碼。例如，如果對資源的請求（例如 PUT）使用了不支援的編碼，則 Accept-Encoding 會包含在 415 Unsupported Media Type 回應中。

即使用戶端和伺服器都支援相同的壓縮演算法，如果是 identity 值也是可接受的，伺服器可能選擇不壓縮回應的主體。這在兩種常見情況下發生：

  1. 資料已經壓縮，這意味著第二輪壓縮不會減少傳輸的資料大小，甚至在某些情況下可能會增加內容大小。這對於預壓縮的圖像格式（例如 JPEG）是正確的。
  2. 伺服器過載，無法分配計算資源來執行壓縮。例如，Microsoft 建議如果伺服器使用超過 80% 的計算能力，則不要壓縮。

只要 identity;q=0 或 *;q=0 指令沒有明確禁止 identity 值（即無編碼），伺服器絕不能返回 406 Not Acceptable 錯誤。

備註：IANA 維護官方內容編碼列表。bzip 和 bzip2 編碼是非標準的，但在某些情況下可能會使用，包括對舊版的支援。

標頭類型 請求標頭、回應標頭
禁止的請求標頭 是

語法

http
Accept-Encoding: gzip
Accept-Encoding: compress
Accept-Encoding: deflate
Accept-Encoding: br
Accept-Encoding: zstd
Accept-Encoding: dcb
Accept-Encoding: dcz
Accept-Encoding: identity
Accept-Encoding: *

// 使用品質值語法加權多個演算法：
Accept-Encoding: deflate, gzip;q=1.0, *;q=0.5

指令

gzip

使用 Lempel-Ziv 編碼（LZ77）和 32 位元的 CRC 的壓縮格式。

compress

使用 Lempel-Ziv-Welch（LZW）演算法的壓縮格式。

deflate

使用具有 deflate 壓縮演算法的 zlib 結構的壓縮格式。

br

使用 Brotli 演算法的壓縮格式。

zstd

使用 Zstandard 演算法的壓縮格式。

dcb

使用 Dictionary-Compressed Brotli 演算法的壓縮格式。參見壓縮字典傳輸指南。

dcz

使用 Dictionary-Compressed Zstandard 演算法的壓縮格式。參見壓縮字典傳輸指南。

identity

表示恆等函數（即無修改或壓縮）。即使省略，此值始終被視為可接受的。

*（萬用字元）

匹配標頭中尚未列出的任何內容編碼。如果標頭不存在，則這是預設值。此指令不表示支援任何演算法，而表示不表達任何偏好。

;q=（加權 q 值）

任何值都按照使用相對品質值（稱為權重）表示的偏好順序。

範例

預設 Accept-Encoding 值

瀏覽器導航通常具有以下 Accept-Encoding 請求標頭值：

http
GET /en-US/ HTTP/2
Host: developer.mozilla.org
Accept-Encoding: gzip, deflate, br, zstd

加權 Accept-Encoding 值

以下標頭顯示使用品質值的 Accept-Encoding 偏好，範圍在 0（最低優先級）和 1（最高優先級）之間。Brotli 壓縮的權重為 1.0，使 br 成為用戶端的首選，其次是權重為 0.8 的 gzip，然後是任何其他內容編碼，權重為 0.1：

http
Accept-Encoding: br;q=1.0, gzip;q=0.8, *;q=0.1

規範

Specification
HTTP Semantics
# field.accept-encoding
Zstandard Compression and the 'application/zstd' Media Type
# name-content-encoding

瀏覽器相容性

參見

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content