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

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
If-Range

Legend

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

Full support
Full support

Veja também