Headers: append() メソッド
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.
メモ: この機能はウェブワーカー内で利用可能です。
append() は Headers インターフェイスのメソッドで、 Headers オブジェクト内の既存のヘッダーに新しい値を追加します。または、既存のヘッダーがない場合には、ヘッダーを追加します。
set() と append() の違いは、指定されたヘッダーがすでに存在し、複数の値を受け入れる場合、set() は既存の値を新しい値で上書きするのに対し、append() は新しい値を値の集合の最後に追加するという点です。
セキュリティ上の理由から、いくつかのヘッダーはユーザーエージェントでしか制御できません。これには、禁止リクエストヘッダーと禁止レスポンスヘッダー名があります。
構文
js
append(name, value)
引数
返値
なし (undefined)。
例
空の Headers オブジェクトの生成はシンプルです。
js
const myHeaders = new Headers(); // 現在は空
append() を使用してヘッダーを追加することができます。
js
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // 'image/jpeg' を返します。
指定されたヘッダーがすでに存在する場合、append() はその値を指定された値に変更します。指定したヘッダーが既に存在し、複数の値を受け入れられる場合、append() は新しい値を値の集合の最後に追加します。
js
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // 'deflate, gzip' を返します。
古い値を新しい値で上書きするには、 Headers.set を使います。
仕様書
| Specification |
|---|
| Fetch # ref-for-dom-headers-append① |