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.

Заголовок запроса Range указывает серверу какую часть документа ему необходимо вернуть. Несколько частей документа может быть запрошено с помощью заголовка Range за один раз, и сервер может вернуть все эти части через многокомпонентный документ. При отправке данных отдельными частями, сервер использует код ответа 206 Partial Content. Если запрашиваемые диапазоны данных не верны, сервер возвращает ошибку 416 Range Not Satisfiable. Сервер так же может проигнорировать заголовок Range и вернуть документ целиком с кодом ответа 200.

Тип заголовка Request header
Forbidden header name нет

Синтаксис

Range: <единица>=<начало-диапазона>-
Range: <единица>=<начало-диапазона>-<конец-диапазона>
Range: <единица>=<начало-диапазона>-<конец-диапазона>, <начало-диапазона>-<конец-диапазона>
Range: <единица>=<начало-диапазона>-<конец-диапазона>, <начало-диапазона>-<конец-диапазона>, <начало-диапазона>-<конец-диапазона>
Range: <единица>=-<длина-с-конца>

Директивы

<единица>

Единица, в которой указывается запрашиваемый диапазон. Обычно объявляется, как bytes.

<начало-диапазона>

Число, в указанных единицах, являющееся началом запрашиваемого диапазона.

<конец-диапазона>

Число, в указанных единицах, являющееся концом запрашиваемого диапазона. Это значение не является обязательным и, если его не определять, концом диапазона будет считаться конец документа.

<длина-с-конца>

Количество единиц документа, которые необходимо вернуть серверу, начиная с конца документа.

Примеры

Запрашивание трёх диапазонов байтов из одного файла.

Range: bytes=200-1000, 2000-6576, 19000-

Запрашивание первых 500 и последних 500 байтов из файла. Запрос может быть отклонён сервером в связи с перекрывающимися диапазонами.

Range: bytes=0-499, -500

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

Спецификация Заголовок
RFC 7233, раздел 3.1: Range Hypertext Transfer Protocol (HTTP/1.1): Range Requests

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

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
Range
CORS-safelisted request header with single bytes range

Legend

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

Full support
Full support

Смотрите также