If-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 If-Range faz uma requisição de intervalo condicional: se a condição é realizada, a requisição de intervalo será enviada e o servidor mandará de volta como resposta um 206 Partial Content com o corpo apropriado. Se a condição não é realizada, a recurso inteiro é enviado de volta, com um código de status 200 OK.

Este cabeçalho pode ser usado ou com um validador Last-Modified, ou com um ETag, mas não com ambos.

O caso de uso mais comum é continuar um download, para garantir que o recurso guardado não tenha sido modificado desde o último fragmento que foi recebido.

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

Sintaxe

If-Range: <nome-dia>, <dia> <mês> <ano> <hora>:<minuto>:<segundo> GMT
If-Range: <etag>

Diretivas

<etag>

Tags de entidade que representam unicamente os recursos requisitados. Eles são uma cadeia de caracteres ASCII colocados entre aspas duplas (como "675af34563dc-tr34"). Elas podem ser prefixadas por W/ para indicar que o algoritmo de comparação fraco deve ser utilizado.

<nome-dia>

Um entre "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", or "Sun" (sensível ao caso).

<dia>

2 digitos, número do dia. Por exemplo "04" ou "23".

<mês>

Um entre "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" (sensível ao caso).

<ano>

4 digitos, número do ano,. Por exemplo. "1990" ou "2016".

<hora>

2 digitos, número da hora. Por exemplo. "09" ou "23".

<minuto>

2 digiitos, número do minuto. Por exemplo. "04" ou "59".

<segundo>

2 digitos, número dos segundo, Por exemplo. "04" ou "59".

GMT

Horário de Greenwich (Greenwich Mean Time). Datas HTTP sempre são expressas em GMT, nunca em tempo local.

Exemplos

If-Range: Wed, 21 Oct 2015 07:28:00 GMT

Especificações

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

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também