此页面由社区从英文翻译而来。了解更多并加入 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>

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

示例

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

规范

规范
HTTP Semantics
# field.range

浏览器兼容性

参见