XMLHttpRequest.getResponseHeader() - Web API 接口参考 编辑

草案
本页尚未完工.

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!

• Desktop
• Mobile

浏览器	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才出现。

也请看看:

• 如何使用XMLHttpRequest
• HTTP headers
• getAllResponseHeaders()
• response
• 设置请求头: setRequestHeader()