Request: headers プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

メモ: この機能はウェブワーカー内で利用可能です。

headersRequest インターフェイスの読み取り専用プロパティで、リクエストに関連する Headers オブジェクトを保持します。

Headers オブジェクト。

次のスニペットは、 Request() コンストラクターを使って(スクリプトと同じディレクトリーにある画像ファイルのために)新しいリクエストを生成してから、リクエストの headers を変数に保存しています。

js
const myRequest = new Request("flowers.jpg");
const myHeaders = myRequest.headers; // Headers {}

Headers オブジェクトにヘッダーを追加するためには、Headers.append を使用します。次に、新しい Request を作成する際に初期化のための第二引数を渡し、初期化オプションとしてヘッダーを渡します。

js
const myHeaders = new Headers();
myHeaders.append("Content-Type", "image/jpeg");

const myInit = {
  method: "GET",
  headers: myHeaders,
  mode: "cors",
  cache: "default",
};

const myRequest = new Request("flowers.jpg", myInit);

const myContentType = myRequest.headers.get("Content-Type"); // returns 'image/jpeg'

仕様書

Specification
Fetch
# ref-for-dom-request-headers②

ブラウザーの互換性

関連項目