Content-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-Content-Range-Response-Header wird in Range-Requests verwendet, um anzugeben, wo der Inhalt eines Antwortkörpers in Bezug auf eine vollständige Ressource einzuordnen ist.

Er sollte nur in 206 Partial Content- oder 416 Range Not Satisfiable-Antworten enthalten sein.

Header-Typ Response-Header, Content-Header
Verbotener Anforderungs-Header Nein
CORS-sicher gelisteter Anforderungs-Header Nein

Syntax

http
Content-Range: <unit> <range>/<size>
Content-Range: <unit> <range>/*
Content-Range: <unit> */<size>

Direktiven

<unit>

Die Einheit zur Angabe von Bereichen. Derzeit wird nur bytes unterstützt.

<range>

Ein Bereich im Format <range-start>-<range-end>, wobei <range-start> und <range-end> ganze Zahlen für die Start- und Endposition (nullbasiert & einschließlich) des Bereichs in der angegebenen <unit> sind. * wird in einer 416 Range Not Satisfiable-Antwort verwendet, um anzuzeigen, dass der Wert kein Bereich ist.

<size>

Die Gesamtlänge des Dokuments (oder *, wenn unbekannt).

Beispiele

Teilweiser Inhaltsantwort

Diese 206 Partial Content-Antwort zeigt eine teilweise Antwort, wobei der Content-Range angibt, dass sie die ersten 1024 Bytes einer 146515 Bytes langen Datei enthält.

http
HTTP/2 206
content-type: image/jpeg
content-length: 1024
content-range: bytes 0-1023/146515
…

(binary content)

Bereich nicht zufriedenstellend

Wenn der Server den angeforderten Bereichsanfrage nicht erfüllen kann, sollte er mit einem 416 Range Not Satisfiable-Status antworten, und der Content-Range sollte * für den Bereich zusammen mit der Gesamtgröße der Ressource angeben.

http
HTTP/2 416

Content-Range: bytes */67589

Spezifikationen

Specification
HTTP Semantics
# field.content-range

Browser-Kompatibilität

Siehe auch