If-Range

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-Anforderungsheader macht eine Bereichsanfrage konditional. Wenn die Bedingung erfüllt ist, wird eine Bereichsanfrage gesendet, und der Server sendet eine 206 Partial Content-Antwort mit Teil(en) der Ressource im Body zurück. 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.

Der häufigste Anwendungsfall ist die Fortsetzung eines Downloads mit der Gewissheit, dass die Ressource auf dem Server nicht verändert wurde, seit der letzte Teil vom Client empfangen wurde.

Header-Typ Anforderungsheader
Verbotener Anforderungsheader Nein

Syntax

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

Direktiven

<etag>

Ein Entitätstag, das die angeforderte Ressource eindeutig repräsentiert. Es ist eine Zeichenkette aus ASCII-Zeichen, die in doppelte Anführungszeichen gesetzt wird (wie "675af34563dc-tr34"). Ein schwaches Entitätstag (eines, das mit W/ vorangestellt ist) darf in diesem Header nicht verwendet werden.

<day-name>

Einer von Mon, Tue, Wed, Thu, Fri, Sat oder Sun (case-sensitive).

<day>

2-stellige Tagesnummer, z.B. "04" oder "23".

<month>

Einer von Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec (case-sensitive).

<year>

4-stellige Jahreszahl, z.B. "1990" oder "2016".

<hour>

2-stellige Stundenzahl, z.B. "09" oder "23".

<minute>

2-stellige Minutenzahl, z.B. "04" oder "59".

<second>

2-stellige Sekundenzahl, z.B. "04" oder "59".

GMT

Greenwich Mean Time. HTTP-Daten werden immer in GMT angegeben, 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

BCD tables only load in the browser

Siehe auch