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 qui est satisfaite

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