If-Range

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 de navegador

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
If-RangeChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support

Veja também