Content-Range 頭

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HTTP Content-Range 響應頭用於範圍請求中,指示響應體內容在完整資源中的位置。

它只應包含在 206 Partial Content416 Range Not Satisfiable 響應中。

頭型別 響應頭, 內容頭
禁止請求頭
CORS 安全列表請求頭

語法

http
Content-Range: <unit> <range>/<size>
Content-Range: <unit> <range>/*
Content-Range: <unit> */<size>

指令

<unit>

指定範圍的單位。目前僅支援 bytes

<range>

範圍格式為 <range-start>-<range-end>,其中 <range-start><range-end> 分別是給定 <unit> 中範圍的起始和結束位置(從零開始且包含在內)的整數。416 Range Not Satisfiable 響應中使用 * 表示該值不是一個範圍。

<size>

文件的總長度(如果未知,則為 *)。

示例

部分內容響應

206 Partial Content 響應顯示了一個部分響應,Content-Range 指示它包含一個 146515 位元組檔案的前 1024 位元組。

http
HTTP/2 206
content-type: image/jpeg
content-length: 1024
content-range: bytes 0-1023/146515
…

(binary content)

範圍無法滿足

如果伺服器無法滿足請求的範圍請求,它應該返回 416 Range Not Satisfiable 狀態,並且 Content-Range 應該為範圍指定 *,以及資源的總大小。

http
HTTP/2 416

Content-Range: bytes */67589

規範

規範
HTTP 語義
# field.content-range

瀏覽器相容性

另見