此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Range

基线
广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Range 请求标头告知服务器返回文件的哪一部分。在一个 Range 标头中,可以一次性请求多个部分,服务器会以 multipart 文件的形式将其返回。如果服务器返回的是范围响应,需要使用 206 Partial Content 状态码。假如所请求的范围不合法,那么服务器会返回 416 Range Not Satisfiable 状态码,表示客户端错误。服务器允许忽略 Range 标头,从而返回整个文件,状态码用 200 。

Header type Request header
Forbidden request header no

语法

http
Range: <unit>=<range-start>-
Range: <unit>=<range-start>-<range-end>
Range: <unit>=<range-start>-<range-end>, …, <range-startN>-<range-endN>
Range: <unit>=-<suffix-length>

指令

<unit>

范围所采用的单位,通常是字节(byte)。

<range-start>

一个整数,表示在特定单位下,范围的起始值。

<range-end>

一个整数,表示在特定单位下,范围的结束值。这个值是可选的,如果不存在,表示此范围一直延伸到文档结束。

示例

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

规范

规范
HTTP Semantics
# field.range

浏览器兼容性

参见