Headers.append()
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
Headers インターフェースの append() メソッドは、Headers オブジェクト内の既存のヘッダに新しい値を追加します。または、既存のヘッダがない場合には、ヘッダを追加します。
Headers.set (en-US) と append() の違いは、特定のヘッダが既に存在して、複数の値を受け入れる場合、Headers.set (en-US) は既存の値を新しい値で上書きますが、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 (en-US) を使います。
仕様
| 仕様 | ステータス | コメント |
|---|---|---|
| Fetch append() の定義 |
現行の標準 |
ブラウザ実装状況
BCD tables only load in the browser