XMLHttpRequest.getResponseHeader()

草案
本页尚未完工.

XMLHttpRequest.getResponseHeader()方法返回包含指定响应头文本的字符串。

如果在返回的响应头中有多个一样的名称,那么返回的值就会是用逗号和空格将值分隔的字符串。getResponseHeader()方法以UTF编码返回值。搜索的报文名是不区分大小写的。

语法

var myHeader = XMLHttpRequest.getResponseHeader(name);

参数

name
一个字符串,表示要返回的报文项名称。

返回值

报文项值,如果连接未完成,响应中不存在报文项,或者被W3C限制,则返回null。

示例:

var client = new XMLHttpRequest();//新建XMLHttpRequest对象。
client.open("GET", "somefile.txt", true);//采用异步,GET方式获取somefile.txt。
client.send();//发送空的query string。
client.onreadystatechange = function() {//设定侦听器onreadystatechange。
  if(this.readyState == this.HEADERS_RECEIVED) {//如果readyState表示响应头已返回
    var contentType=client.getResponseHeader("Content-Type"));//将此连接的Content-Type响应头项赋值到contentType。
    if(contentType != my_expected_type) {//如果这不是你的预期值
      client.abort();//终止连接
    }    
  }
}

规范

规范 状态 注释
XMLHttpRequest
getResponseHeader()
Living Standard WHATWG living standard

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
浏览器 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基础支持 1 (Yes) ?[1] 5[2]
7
(Yes) 1.2

浏览器

Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基础支持 ? 1.0 (Yes) (Yes) ? ? ?

[1]从Firefox 49开始,在首选项network.http.keep_empty_response_headers_as_empty_string设置为true的情况下,空响应头将作为空字符串返回,默认为false。 在Firefox 49之前,空响应头已被忽略。从Firefox 50开始,该项默认设置为true。

[2]该功能最开始是通过ActiveXObject()实现的。 直到Internet Explorer 7,标准的XMLHttpRequest才出现。

也请看看: