Spec-Zone.ru › HTTP

Диапазон

Диапазон

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

Тип заголовка Заголовок запроса
Запрещённое имя заголовка нет

Синтаксис

Range: <unit>=<range-start>-
Range: <unit>=<range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>
Range: <unit>=-<suffix-length>

Директивы

<unit>

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

<range-start>

Целое число в заданной единице, указывающее начало запрошенного диапазона.

<range-end>

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

<suffix-length>

Целое число в заданной единице, указывающее количество единиц в конце файла для возврата.

Примеры

Запрос трех диапазонов из файла.

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

Значение спецификатора диапазонов 19000- указывает 19000 как первую позицию и опускает последнюю позицию — чтобы указать, что все байты с 19000 и далее являются частью третьего диапазона.

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

Range: bytes=0-499, -500

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

Спецификация
Семантика HTTP
# field.range

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet
Range
Да
12
Да
Да
Да
Да
Да
Да
Да
Да
Да
Да

См. также

  • If-Range
  • Content-Range
  • Content-Type
  • 206 Partial Content
  • 416 Range Not Satisfiable

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API