XMLHttpRequest: getResponseHeader() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用,但 Service Workers 除外。

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

瀏覽器相容性

另見