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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Range
CORS-safelisted request header with single bytes range

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também