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 de navegador
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.