{{domxref("XMLHttpRequest")}} の getAllResponseHeaders() メソッドは、すべてのレスポンスヘッダーを {{Glossary('CRLF')}} で区切った文字列として返し、レスポンスを受信していない場合は null を返します。ネットワークエラーが発生した場合は、空文字列が返されます。
注: マルチパートリクエストでは、これはリクエストの元のチャンネルではなく、現在の部分を返します。
var headers = XMLHttpRequest.getAllResponseHeaders();
なし。
{{Glossary('CRLF')}} で区切ったすべてのレスポンスヘッダー (フィールド名が Set-Cookie または Set-Cookie2 のものを除く) を表す {{domxref("ByteString")}}、またはレスポンスを受信していなければ null です。ネットワークエラーが発生した場合は、空文字列が返されます。
生のヘッダー文字列がどのように見えるかの例です。
date: Fri, 08 Dec 2017 21:04:30 GMT\r\n
content-encoding: gzip\r\n
x-content-type-options: nosniff\r\n
server: meinheld/0.6.1\r\n
x-frame-options: DENY\r\n
content-type: text/html; charset=utf-8\r\n
connection: keep-alive\r\n
strict-transport-security: max-age=63072000\r\n
vary: Cookie, Accept-Encoding\r\n
content-length: 6502\r\n
x-xss-protection: 1; mode=block\r\n
各行はキャリッジリターンとラインフィード文字 (\r\n) の両方で終わります。これらはそれぞれのヘッダーを区切る基本的なデリミターです。
注: 最近のブラウザーでは、ヘッダー名は最新の仕様書にあるように、すべて小文字で返されます。
この例では、リクエストの {{event("readystatechange")}} イベントハンドラーである {{domxref("XMLHttpRequest.onreadystatechange")}} の中でヘッダーを調べます。このコードは生のヘッダー文字列を取得する方法、またそれを個別のヘッダーの配列に変換する方法、そして配列からヘッダー名とその値のマップを生成する方法を示しています。
var request = new XMLHttpRequest();
request.open("GET", "foo.txt", true);
request.send();
request.onreadystatechange = function() {
if(this.readyState == this.HEADERS_RECEIVED) {
// 生のヘッダー文字列を取得
var headers = request.getAllResponseHeaders();
// ヘッダー文字列を個別のヘッダーの
// 配列に変換
var arr = headers.trim().split(/[\r\n]+/);
// ヘッダー名と値のマップを生成
var headerMap = {};
arr.forEach(function (line) {
var parts = line.split(': ');
var header = parts.shift();
var value = parts.join(': ');
headerMap[header] = value;
});
}
}
いったんこれを行えば、次のようなことができます。
var contentType = headerMap["content-type"];
これは {{httpheader("Content-Type")}} ヘッダーの値を変数 contentType の中に入れます。
| 仕様書 | 状態 | 備考 |
|---|---|---|
| {{SpecName('XMLHttpRequest', '#the-getallresponseheaders()-method', 'getAllResponseHeaders()')}} | {{Spec2('XMLHttpRequest')}} | WHATWG living standard |