If-Range
HTTP 请求头字段用来使得 Range
头字段在一定条件下起作用:当字段值中的条件得到满足时,Range
头字段才会起作用,同时服务器回复206
部分内容状态码,以及Range
头字段请求的相应部分;如果字段值中的条件没有得到满足,服务器将会返回 200
OK
状态码,并返回完整的请求资源。
字段值中既可以用 Last-Modified
时间值用作验证,也可以用ETag
标记作为验证,但不能将两者同时使用。
If-Range
头字段通常用于断点续传的下载过程中,用来自从上次中断后,确保下载的资源没有发生改变。
Header type | Request header |
---|---|
Forbidden header name | no |
语法
If-Range: <星期>, <日> <月> <年> <时>:<分>:<秒> GMT If-Range: <etag>
说明
- <etag>
- 一个资源标签(entity tag)代表着所请求的资源。它是由被双引号包围的ACSII 编码的字符串组成的(例如
"675af34563dc-tr34"
)。当应用弱匹配算法时,E-Tag会有一个W/
前缀。
- <星期>
"Mon"
,"Tue"
,"Wed"
,"Thu"
,"Fri"
,"Sat"
或者"Sun"
当中的一个(大小写敏感)。- <日>
- 两位数字,例如
"04"或者"23"
。 - <月>
"Jan"
,"Feb","Mar"
,"Apr"
,"May"
,"Jun"
,"Jul"
,"Aug"
,"Sep"
,"Oct"
,"Nov"
,或者"Dec"
中的一个(大小写敏感)。- <年>
- 四位数字,例如
"1990"或者"2016"。
- <时>
- 两位数字,例如
"09"或者"23"
。 - <分>
- 两位数字,例如
"04"或者"59"
。 - <秒>
- 两位数字,例如
"04"或者"59"
。 GMT
-
格林威治标准时间。HTTP 协议的日期总是要使用GMT,而不是当地时间。
示例
If-Range: Wed, 21 Oct 2015 07:28:00 GMT
规范
Specification | Title |
---|---|
RFC 7233, section 3.2: If-Range | Hypertext Transfer Protocol (HTTP/1.1): Range Requests |
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Servo |
---|---|---|---|---|---|---|---|
If-Range | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge Mobile | Firefox for Android | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
If-Range | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |