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.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 Standard
# ref-for-dom-request-headers②

ブラウザーの互換性

BCD tables only load in the browser

関連項目