Range は HTTP のリクエストヘッダーで、サーバーが返すべき文書の部分を示します。1 つのRange ヘッダーで複数の部分を一度にリクエストすることができ、サーバーはこれらの範囲をマルチパートの文書で返すことができます。サーバーが範囲を送り返す場合、サーバーはレスポンスに206Partial Content を使用します。範囲が無効な場合、サーバーは416Range Not Satisfiable エラーを返します。サーバーはRange ヘッダーを無視して、文書全体を200 のステータスコードで返すこともできます。

構文

Range: <unit>=<range-start>-Range: <unit>=<range-start>-<range-end>Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>Range: <unit>=-<suffix-length>

ディレクティブ

<unit>

範囲を指定する単位です。これはふつうbytes です。

<range-start>

整数値で、リクエストする範囲の先頭を指定した単位で示します。

<range-end>

整数値で、リクエストする範囲の末尾を指定した単位で示します。この値は省略可能で、省略時は文書の末尾が範囲の末尾として扱われます。

<suffix-length>

整数値で、返す長さを位でファイルの末尾からの個数を示します。

例

ファイルから 3 つの範囲をリクエストします。

Range: bytes=200-1000, 2000-6576, 19000-

ファイルの先頭の 500 バイトと末尾の 500 バイトをリクエストします。範囲が重複した場合はサーバーがリクエストを拒否することがあります。

Range: bytes=0-499, -500

仕様書

ブラウザーの互換性

関連情報

• If-Range
• Content-Range
• Content-Type
• 206Partial Content
• 416Range Not Satisfiable