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.

O cabeçalho de requisição HTTP Range indica a parte do documento que o servidor deve retornar. Várias partes podem ser requisitadas com um cabeçalho Range de uma vez, e o servidor pode mandar de volta estes intervalos em um documento de múltiplas partes. Se o servidor manda de volta os intervalos, ele usa o 206 Partial Content para resposta. Se os intervalos são inválidos, o servidor retorna o erro 416 Range Not Satisfiable. O servidor também pode ignorar o cabeçalho Range e enviar o documento inteiro com um código de status 200.

Tipo de cabeçalho Request header
Forbidden header name não

Sintaxe

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>

Diretivas

<unit>

A unidade no qual os intervalos são especificados. É geralmente em bytes.

<range-start>

Um inteiro na dada unidade indicando o começo da requisição de intervalo.

<range-end>

Um inteiro na dada unidade indicando o fim da requisição de intervalo. Este valor é opcional e, se omitido, o fim do documento é utilizado como fim do intervalo.

<suffix-length>

Um inteiro na dada unidade indicando o número de unidades ao fim do arquivo para retornar.

Exemplos

Requisitando três intervalos deste arquivo.

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

Requisitando os primeiros 500 e últimos 500 bytes do arquivo. A requisição pode ser rejeitada pelo servidor se os intervalos se sobrepõem.

Range: bytes=0-499, -500

Especificações

Especificação Título
RFC 7233, sessão 3.1: Range Hypertext Transfer Protocol (HTTP/1.1): Range Requests

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também