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 porW/
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