XMLHttpRequest:getResponseHeader() 方法

基线 广泛可用

此功能已得到良好建立,并且可在许多设备和浏览器版本上运行。它自以下时间以来已在浏览器中可用 2015 年 7 月.

注意:此功能在Web 工作线程中可用,但服务工作线程除外。

XMLHttpRequest方法getResponseHeader()返回包含特定标头值的文本的字符串。

如果有多个具有相同名称的响应标头,则其值将作为单个连接的字符串返回,其中每个值都用逗号和空格对与前一个值分隔。getResponseHeader()方法将值作为 UTF 字节序列返回。

注意:标头名称的搜索不区分大小写。

如果您需要获取所有标头的原始字符串,请使用getAllResponseHeaders()方法,该方法返回整个原始标头字符串。

语法

js
getResponseHeader(headerName)

参数

headerName

一个字符串,指示要返回其文本值的标头的名称。

返回值

表示标头文本值的字符串,或者如果尚未收到响应或响应中不存在该标头,则为null

示例

在此示例中,创建并发送了一个请求,并建立了一个readystatechange处理程序来查找readyState以指示已收到标头;在这种情况下,将获取Content-Type标头的值。如果Content-Type不是所需的值,则通过调用abort()取消XMLHttpRequest

js
const client = new XMLHttpRequest();
client.open("GET", "unicorns-are-awesome.txt", true);
client.send();

client.onreadystatechange = () => {
  if (client.readyState === client.HEADERS_RECEIVED) {
    const contentType = client.getResponseHeader("Content-Type");
    if (contentType !== my_expected_type) {
      client.abort();
    }
  }
};

规范

规范
XMLHttpRequest 标准
# dom-xmlhttprequest-getresponseheader

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅