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 Standard # ref-for-dom-headers-append① |
ブラウザーの互換性
BCD tables only load in the browser