| title | slug | l10n | ||
|---|---|---|---|---|
Headers.get() |
Web/API/Headers/get |
|
{{APIRef("Fetch")}}
get() は {{domxref("Headers")}} インターフェイスのメソッドで、指定された名前の Headers オブジェクト内のヘッダーのすべての値のバイト文字列を返します。要求されたヘッダーが Headers オブジェクトに存在しない場合、null を返します。
セキュリティ上の理由から、いくつかのヘッダーはユーザーエージェントでしか制御できません。これには、{{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}}と{{Glossary("Forbidden_response_header_name", "禁止レスポンスヘッダー名", 1)}}があります。
get(name)
name- :
Headersオブジェクトから値を取得する HTTP ヘッダーの名前。指定された名前が HTTP ヘッダーの名前でない場合、このメソッドでは {{jsxref("TypeError")}} 例外が発生します。名前は大文字と小文字を区別しません。
- :
取得したヘッダーの値を表す文字列の配列です。このヘッダーが設定されていない場合は null を返します。
空の Headers オブジェクトの作成は簡単です。
const myHeaders = new Headers(); // 現在空です
myHeaders.get("Not-Set"); // null を返します{{domxref("Headers.append")}} を使用してヘッダーを追加し、get() を使用してヘッダーを取得できます。
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // "image/jpeg" を返しますヘッダーに複数の値が関連付けられている場合、ByteString には、Headers オブジェクトに追加された順序ですべての値が含まれます。
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // "deflate,gzip" を返します
myHeaders
.get("Accept-Encoding")
.split(",")
.map((v) => v.trimStart()); // [ "deflate", "gzip" ] を返します。{{Specifications}}
{{Compat}}