Content-Range ヘッダー
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
HTTP の Content-Range レスポンスヘッダーは、範囲リクエストにおいて、レスポンス本体のコンテンツがリソース全体の中でどの範囲に該当するかを示すために使用されます。
これは、206 Partial Content または 416 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>における範囲の開始位置および終了位置（0 から数え、両端を含む）を表す整数です。*は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
…
（バイナリーコンテンツ）
範囲に対応できない場合
サーバーがリクエストされた範囲に対応できない場合、416 Range Not Satisfiable ステータスをつけて応答し、Content-Range には範囲として * を指定するとともに、リソースの合計サイズも明記する必要があります。
http
HTTP/2 416
Content-Range: bytes */67589
仕様書
| 仕様書 |
|---|
| HTTP Semantics # field.content-range |
ブラウザーの互換性
関連情報
- HTTP 範囲付きリクエストガイド
If-Range,RangeヘッダーContent-Type206 Partial Content,416 Range Not Satisfiableステータスコード