Headers

Fetch API の Headers インターフェースは、HTTP リクエストとレスポンスのヘッダ上のさまざまなアクションを実行します。これらのアクションには、取得や設定、追加、削除が含まれます。Headers オブジェクトは、最初は空で 0 個以上の名前と値のペアで構成される関連するヘッダリストを持っています。追加には append()（例 を見てください）のようなメソッドを使用できます。このインタフェースのすべてのメソッドで、ヘッダ名は大文字と小文字を区別しないバイトシーケンスにマッチしています。

セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでしか制御できません。それらのヘッダには、forbidden header names と forbidden response header names が含まれます。

ヘッダは関連するガードも持っています。ガードは immutable か request、request-no-cors、response、none のいずれかの値を取ります。これはヘッダを変更する set() メソッドと delete() メソッド、append() メソッドに影響を与えます。詳細は Guard を見てください。

Request.headers プロパティと Response.headers プロパティ経由で Headers オブジェクトを取得することも、Headers.Headers() コンストラクタを使用して新しい Headers オブジェクトを生成することもできます。

Headers を実装したオブジェクトは、entries() の代わりに直接 for...of 構文で使用できます： for (var p of myHeaders) と for (var p of myHeaders.entries()) は同等です。

コンストラクタ

Headers.Headers()

新しい Headers オブジェクトを生成する。

メソッド

Headers.append()

Headers オブジェクト内の既存のヘッダに新しい値を追加するか、まだ存在しない場合はヘッダを追加する。

Headers.delete()

Headers オブジェクトからヘッダを削除する。

Headers.entries()

このオブジェクトに含まれるすべてのキー/値 ペアを通して処理するための iterator を返す。

Headers.get()

Headers オブジェクト内から指定したヘッダのすべての値の ByteString を返す。

Headers.has()

Headers オブジェクトが特定のヘッダを含むかどうかを示す boolean 値を返す。

Headers.keys()

このオブジェクトに含まれるキー/値 ペアのすべてのキーを通して処理するための iterator を返す。

Headers.set()

オブジェクト内の既存のヘッダに新しい値を設定するか、まだ存在しない場合はヘッダを追加する。

Headers.values()

このオブジェクトに含まれるキー/値 ペアのすべての値を通して処理するための iterator を返す。

廃止になった機能

Headers.getAll()

Headers オブジェクト内で指定されたヘッダのすべての値を配列として返す。このメソッドは規格から削除されており、 Headers.get() は現在では与えられた名前に一致する最初のものを返します。

例

次のコードスニペットでは、Headers() コンストラクタを使用して新しいヘッダを生成し、append() を使用して新しいヘッダを追加しています。その後、get() を使用してヘッダの値を返しています：

var myHeaders = new Headers();

myHeaders.append('Content-Type', 'text/xml');
myHeaders.get('Content-Type') // 'text/xml' を返す。

同じことがコンストラクタにオブジェクトリテラルか配列リテラルの配列リテラルを渡すことでできます。

var myHeaders = new Headers({
    'Content-Type': 'text/xml'
});

// or, using an array of arrays:
myHeaders = new Headers([
    ['Content-Type', 'text/xml']
]);

myHeaders.get('Content-Type') // should return 'text/xml'

仕様

ブラウザ実装状況

関連項目

• ServiceWorker API
• HTTP アクセス制御 (CORS)
• HTTP