Headers()

Headers() コンストラクターは新しい Headers オブジェクトを生成します。

文法

var myHeaders = new Headers(init);

引数

init 省略可
Headers に前もって設定したい HTTP headers を含むオブジェクト。これは ByteString を持つ単純なオブジェクトリテラルか、既存の Headers オブジェクトのどちらかです。最後の例では、新しい Headers オブジェクトは既存の Headers オブジェクトからデータを継承します。

簡単に空の Headers オブジェクトを生成できます。

var myHeaders = new Headers(); // Currently empty

Headers.append を使用してヘッダーを追加できます。

myHeaders.append('Content-Type', 'image/jpeg');
myHeaders.get('Content-Type'); // Returns 'image/jpeg'

または、Headers オブジェクトの生成時に必要なヘッダーを追加することもできます。次のスニペットでは、新しい Headers を作成し、コンストラクターに init オブジェクトを引数として渡してヘッダーを追加しています。

var httpHeaders = { 'Content-Type' : 'image/jpeg', 'Accept-Charset' : 'utf-8', 'X-My-Custom-Header' : 'Zeke are cool' };
var myHeaders = new Headers(httpHeaders);

最初の Headers を init オブジェクトとして渡して、別の Headers オブジェクトを生成できます。

var secondHeadersObj = new Headers(myHeaders);
secondHeadersObj.get('Content-Type'); // Would return 'image/jpeg' — it inherits it from the first headers object

仕様書

仕様書 状態 備考
Fetch
Headers() の定義
現行の標準


関連情報