1. Tecnologia Web para desenvolvedores
  2. HTTP
  3. Reference
  4. Cabeçalhos HTTP
  5. Range

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Range

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 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

Veja também

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content