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.

La cabecera de petición HTTP, Range, indica qué parte de un documento debe devolver el servidor. Varias partes pueden ser solicitadas con una sola cabecera Range a la vez, y el servidor puede enviar estas partes en un documento multipartes. Si el servidor devuelve rangos, utiliza 206 Contenido Parcial. Si los rangos son inválidos, el servidor devuelve el error 416 No se puede satisfacer Range. El servidor también puede ignorar el encabezado de Rango y devolver el documento completo con un código de estado 200.

Tipo de cabecera Encabezado de petición
Nombre de header prohibido no

Sintáxis

http
Range: <unit>=<range-start>-
Range: <unit>=<range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=-<suffix-length>

Directivas

<unit>

La unidad en la cual los rangos son especificados. Usualmente son bytes.

<range-start>

Un número entero correspondiente a las unidades especificadas, indicando el principio del rango requerido.

<range-end>

Un número entero correspondiente a las unidades especificadas, indicando el final del range requerido. Este valor es opcional, si es omitido el final del documento es considerando como el final del rango.

<suffix-length>

Un número entero correspondiente a las unidades especificadas indicando el número de unidades al final del archivo devuelto.

Ejemplos

Solicitando tres rangos de un archivo.

http
Range: bytes=200-1000, 2000-6576, 19000-

El valor, 19000-, del tercer rango especificado, indica que 19000 es la primera posición y omite la última posición -, para recuperar todos los bytes desde 19000 hasta el final del archivo.

Solicitar los primeros y últimos 500 bytes de un archivo. La petición puede ser rechazada por el servidor si los rangos se superponen.

http
Range: bytes=0-499, -500

Especificaciones

Specification
HTTP Semantics
# field.range

Compatibilidad con navegadores

BCD tables only load in the browser

Véase también