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-Antwortheader wird in Bereichsanfragen verwendet, um anzuzeigen, wo der Inhalt eines Antwortkörpers im Verhältnis zu einer vollständigen Ressource gehört.

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

Header-Typ Antwortheader, Inhaltsheader
Verbotener Anforderungsheader Nein
CORS-safelisted Anforderungsheader Nein

Syntax

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

Direktiven

<unit>

Die Einheit zur Angabe der Bereiche. Derzeit wird nur bytes unterstützt.

<range>

Ein Bereich mit dem Format <range-start>-<range-end>, wobei <range-start> und <range-end> ganze Zahlen für die Start- und Endposition (nullbasiert & inklusive) 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

Antwort mit Teilinhalt

Diese 206 Partial Content-Antwort zeigt eine Teilantwort, wobei Content-Range angibt, dass sie die ersten 1024 Bytes einer 146515 Byte großen 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 spezifizieren.

http
HTTP/2 416

Content-Range: bytes */67589

Spezifikationen

Specification
HTTP Semantics
# field.content-range

Browser-Kompatibilität

Siehe auch