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 Request-Header macht eine Bereichsanforderung konditional. Wenn die Bedingung erfüllt ist, wird eine Bereichsanforderung ausgeführt, und der Server sendet eine 206 Partial Content-Antwort mit einem Teil (oder Teilen) 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 das Fortsetzen eines Downloads mit der Garantie, dass die Ressource auf dem Server seit dem Empfang des letzten Teils durch den Client nicht verändert wurde.

Header-Typ Request-Header
Verbotener Header-Name 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 ein String aus ASCII-Zeichen, der in Anführungszeichen gesetzt wird (z. B. "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 (Groß-/Kleinschreibung beachten).

<day>

2-stelliger Tageszahl, z. B., "04" oder "23".

<month>

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

<year>

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

<hour>

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

<minute>

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

<second>

2-stellige Sekundenanzahl, 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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
If-Range

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch