Content-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 Content-Range Antwort-Header wird in Bereichsanfragen verwendet, um anzuzeigen, wo der Inhalt eines Antwortkörpers in Bezug auf eine vollständige Ressource steht.

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

Header-Typ Antwort-Header, Inhalts-Header
Verbotener Header-Name Nein
CORS-Whitelist-Anfrage-Header Nein

Syntax

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

Direktiven

<unit>

Die Einheit zur Spezifikation von Bereichen. Aktuell wird nur bytes unterstützt.

<range>

Ein Bereich im Format <range-start>-<range-end>, wobei <range-start> und <range-end> Integer-Werte für die Start- und Endposition (nullbasiert & inklusiv) 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 *, falls unbekannt).

Beispiele

Teilinhalts-Antwort

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

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

(binary content)

Bereich nicht erfüllbar

Wenn der Server die angeforderte Bereichsanfrage nicht erfüllen kann, sollte er mit einem 416 Range Not Satisfiable-Status antworten, und 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

BCD tables only load in the browser

Siehe auch