En-tête Content-Range

Syntaxe

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

Directives

<unit>

L'unité pour définir les plages. Actuellement, seul bytes est pris en charge.

<range>

Une plage au format <range-start>-<range-end>, où <range-start> et <range-end> sont des entiers représentant respectivement la position de début et de fin (indexée à partir de zéro et incluse) de la plage dans l'unité donnée. * est utilisé dans une réponse 416 Range Not Satisfiable pour indiquer que la valeur n'est pas une plage.

<size>

La longueur totale du document (ou * si inconnue).

Exemples

Réponse avec contenu partiel

Cette réponse 206 Partial Content montre une réponse partielle, avec le Content-Range indiquant qu'elle contient les 1024 premiers octets d'un fichier de 146515 octets.

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

(contenu binaire)

Plage non satisfaisable

Si le serveur ne peut pas satisfaire la requête de plage demandée, il doit répondre avec le statut 416 Range Not Satisfiable, et le Content-Range doit indiquer * pour la plage ainsi que la taille totale de la ressource.

HTTP/2 416

Content-Range: bytes */67589

Spécifications

Compatibilité des navigateurs

Voir aussi

• Le guide sur les requêtes de plage HTTP
• Les en-têtes If-Range, Range
• L'en-tête Content-Type
• Les codes de statut 206 Partial Content, 416 Range Not Satisfiable