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