If-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 If-Range Request-Header macht eine Bereichsanfrage konditional. Wenn die Bedingung erfüllt ist, wird eine Bereichsanfrage gesendet, und der Server antwortet mit einer 206 Partial Content-Antwort, die einen Teil (oder Teile) der Ressource im Body enthält. Wenn die Bedingung nicht erfüllt ist, wird die vollständige Ressource mit einem 200 OK-Status zurückgesendet.

Dieser Header kann entweder mit dem Last-Modified-Validator oder mit ETag verwendet werden, aber nicht mit beiden gleichzeitig.

Der häufigste Anwendungsfall ist das Fortsetzen eines Downloads mit der Garantie, dass die Ressource auf dem Server seit dem letzten Teil, der vom Client empfangen wurde, nicht verändert wurde.

Header-Typ Request-Header
Verbotener Request-Header Nein

Syntax

http
If-Range: <day-name>, <day> <month> <year> <hour>:<minute>:<second> GMT
If-Range: <etag>

Direktiven

<etag>

Ein Entity-Tag, das die angeforderte Ressource eindeutig repräsentiert. Es ist eine Zeichenkette aus ASCII-Zeichen, die in Anführungszeichen gesetzt ist (z.B. "675af34563dc-tr34"). Ein schwaches Entity-Tag (eines, das mit W/ beginnt) darf in diesem Header nicht verwendet werden.

<day-name>

Einer von Mon, Tue, Wed, Thu, Fri, Sat oder Sun (Groß-/Kleinschreibung beachten).

<day>

Zweistellige Tagesnummer, z.B. "04" oder "23".

<month>

Einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec (Groß-/Kleinschreibung beachten).

<year>

Vierstellige Jahreszahl, z.B. "1990" oder "2016".

<hour>

Zweistellige Stundenzahl, z.B. "09" oder "23".

<minute>

Zweistellige Minutenzahl, z.B. "04" oder "59".

<second>

Zweistellige Sekundenzahl, z.B. "04" oder "59".

GMT

Greenwich Mean Time. HTTP-Daten werden immer in GMT ausgedrückt, niemals in Ortszeit.

Beispiele

http
If-Range: Wed, 21 Oct 2015 07:28:00 GMT

If-Range: "67ab43"

Spezifikationen

Specification
HTTP Semantics
# field.if-range

Browser-Kompatibilität

Siehe auch