Range header

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der HTTP Range Request-Header gibt den Teil einer Ressource an, den der Server zurückgeben soll. Mehrere Teile können gleichzeitig in einem Range-Header angefordert werden, und der Server kann diese Bereiche in einem mehrteiligen Dokument zurücksenden. Wenn der Server Bereiche zurücksendet, verwendet er den 206 Partial Content-Statuscode für die Antwort. Wenn die Bereiche ungültig sind, gibt der Server den Fehler 416 Range Not Satisfiable zurück.

Ein Server, der keine Bereichsanfragen unterstützt, kann den Range-Header ignorieren und die gesamte Ressource mit einem 200-Statuscode zurückgeben. Ältere Browser verwendeten einen Response-Header von Accept-Ranges: none, um Funktionen wie "Pause" oder "Fortsetzen" in Download-Managern zu deaktivieren. Da jedoch ein Server, der den Range-Header ignoriert, die gleiche Bedeutung hat wie das Antworten mit Accept-Ranges: none, wird der Header selten auf diese Weise verwendet.

Derzeit sind nur bytes-Einheiten registriert, die Offsets sind (nullbasiert und inklusiv). Wenn die angeforderten Daten eine Inhaltskodierung angewendet haben, stellt jeder Bytebereich die kodierte Bytesequenz dar, nicht die Bytes, die nach dem Dekodieren erhalten würden.

Der Header ist ein CORS-sicherer Request-Header, wenn die Anweisung einen einzelnen Bytebereich angibt.

Header-Typ Request Header
Verbotener Request-Header Nein

Syntax

http
Range: <unit>=<range-start>-
Range: <unit>=<range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, …, <range-startN>-<range-endN>
Range: <unit>=-<suffix-length>

Direktiven

<unit>

Die Einheit, in der Bereiche definiert sind. Derzeit sind nur bytes eine registrierte Einheit.

<range-start>

Ein Ganzzahlwert in der angegebenen Einheit, der die Startposition des Anforderungsbereichs angibt.

<range-end>

Ein Ganzzahlwert in der angegebenen Einheit, der die Endposition des angeforderten Bereichs angibt. Dieser Wert ist optional und, wenn weggelassen, wird das Ende der Ressource als Endpunkt des Bereichs verwendet.

<suffix-length>

Eine Ganzzahl, die die Anzahl der am Ende der Ressource zurückzugebenden Einheiten angibt.

Beispiele

Die folgenden Beispiele zeigen, wie man Anfragen mit dem Range-Header für CORS-sicher gelistete Anfragen und für das Anfordern mehrerer Bereiche stellt. Weitere Beispiele finden Sie im HTTP-Bereichsanfragen-Leitfaden.

Einzelne Bytebereiche und CORS-sichere Anfragen

Der Range-Header ist ein CORS-sicherer Request-Header, wenn der Wert ein einzelner Bytebereich ist. Das bedeutet, dass er in Cross-Origin-Anfragen verwendet werden kann, ohne eine Vorauswahl-Anfrage auszulösen, was nützlich ist für das Anfordern von Medien und das Fortsetzen von Downloads.

Das folgende Beispiel fordert die ersten 500 Bytes einer Ressource an:

http
Range: bytes=0-499

Um die zweiten 500 Bytes anzufordern:

http
Range: bytes=500-999

Das Weglassen der Endposition fordert alle verbleibenden Einheiten der Ressource an, sodass die letzten 100 Bytes einer Ressource mit einer Länge von 1000 Bytes angefordert werden können, indem man verwendet:

http
Range: bytes=900-

Alternativ, wenn nicht bekannt ist, wie groß eine Ressource ist, können die letzten n Bytes unter Verwendung eines Suffixbereichs von -n angefordert werden:

http
Range: bytes=-100

Anfordern mehrerer Bereiche

Gegeben ist eine Ressource mit einer Länge von 10000 Bytes, das folgende Beispiel fordert drei separate Bereiche an: 200-999 (800 Bytes), 2000-2499 (500 Bytes) und schließlich 9500-. Der Bereichsspezifizierwert 9500- weglässt eine Endposition, was anzeigt, dass alle Bytes von 9500 an Teil des dritten Bereichs sind (500 Bytes).

http
Range: bytes=200-999, 2000-2499, 9500-

Dieses Beispiel fordert die ersten 500 und letzten 500 Bytes der Datei an. Die Anfrage kann vom Server abgelehnt werden, wenn sich diese Bereiche überlappen (wenn die angeforderte Ressource kürzer als 1000 Bytes war, zum Beispiel).

http
Range: bytes=0-499, -500

Prüfen, ob ein Server Bereichsanfragen unterstützt

Der folgende Curl-Befehl macht eine HEAD-Anfrage für ein Bild:

bash
curl -v --http1.1 -I https://i.imgur.com/z4d4kWk.jpg
# or using the OPTIONS method:
# curl -v --http1.1 -X OPTIONS https://i.imgur.com/z4d4kWk.jpg

Dies führt zur folgenden HTTP-Anfrage:

http
HEAD /z4d4kWk.jpg HTTP/1.1
Host: i.imgur.com
User-Agent: curl/8.7.1
Accept: */*

Der Server antwortet mit einer 200-Antwort, und der Accept-Ranges: bytes-Header ist vorhanden (einige Header werden zur Kürze weggelassen):

http
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 146515
Content-Type: image/jpeg
…
Accept-Ranges: bytes

Spezifikationen

Specification
HTTP Semantics
# field.range

Browser-Kompatibilität

Siehe auch