この記事は編集レビューを必要としています。ぜひご協力ください。
これは実験段階の機能です。
この機能は複数のブラウザで開発中の状態にあります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザの将来のバージョンで変更になる可能性があることに注意してください。
Headers
インターフェースの append()
メソッドは、Headers
オブジェクト内の既存のヘッダに新しい値を追加します。または、既存のヘッダがない場合には、ヘッダを追加します。
Headers.set
と append()
の違いは、特定のヘッダが既に存在して、複数の値を受け入れる場合、Headers.set
は既存の値を新しい値で上書きますが、append()
は値の最後に新しい値を追加します。
セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでのみ制御できます。それらのヘッダは、forbidden header names と forbidden response header names を含みます。
構文
myHeaders.append(name,value);
パラメータ
- name
Headers
オブジェクトに追加する HTTP ヘッダ名。- value
- HTTP ヘッダに追加する値。
戻り値
Void。
例
空の Headers
オブジェクトの生成はシンプルです:
var 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.getAll('Accept-Encoding'); // [ "deflate", "gzip" ] を返します。
古い値を新しい値で上書きするには、Headers.set
を使います。
仕様
仕様 | ステータス | コメント |
---|---|---|
Fetch append() の定義 |
現行の標準 |
ブラウザ実装状況
機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
基本サポート | 42 41 behind pref |
39 (39) 34 behind pref |
未サポート |
29 |
未サポート |
機能 | Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
基本サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |