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②

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
headers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連項目