HTTP-заголовок If-Range запроса делает запрос диапазона условным. Если условие выполнено, отправляется запрос диапазона, и сервер возвращает ответ 206 Partial Content с частью (или частями) ресурса в теле. Если условие не выполнено, возвращается весь ресурс со статусом 200 OK.

Этот заголовок можно использовать либо с валидатором Last-Modified, либо с ETag, но не с обоими одновременно.

Чаще всего этот заголовок используется для возобновления загрузки с гарантией того, что ресурс на сервере не изменился с момента получения клиентом последней части.

Синтаксис

If-Range: <day-name>, <day> <month> <year> <hour>:<minute>:<second> GMT
If-Range: <etag>

Директивы

<etag>

Тег сущности, однозначно представляющий запрошенный ресурс. Это строка символов ASCII в двойных кавычках (например, "675af34563dc-tr34"). Слабый тег сущности (с префиксом W/) нельзя использовать в этом заголовке.

<day-name>

Одно из значений Mon, Tue, Wed, Thu, Fri, Sat или Sun (с учётом регистра).

<day>

Двузначное число дня, например «04» или «23».

<month>

Одно из значений Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec (с учётом регистра).

<year>

Четырёхзначное число года, например «1990» или «2016».

<hour>

Двузначное число часа, например «09» или «23».

<minute>

Двузначное число минут, например «04» или «59».

<second>

Двузначное число секунд, например «04» или «59».

GMT

Среднее время по Гринвичу. Даты HTTP всегда указываются по GMT, а не по местному времени.

Примеры

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

If-Range: "67ab43"

Спецификации

Совместимость с браузерами

См. также

• Руководство «Условные запросы HTTP»
• ETag
• Last-Modified
• If-Match, If-Modified-Since, If-Unmodified-Since, If-None-Match — заголовки условных запросов
• 206 Partial Content, 412 Precondition Failed, 416 Range Not Satisfiable — коды состояния ответа