From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/headers/append/index.html | 141 +++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 files/ja/web/api/headers/append/index.html (limited to 'files/ja/web/api/headers/append/index.html') diff --git a/files/ja/web/api/headers/append/index.html b/files/ja/web/api/headers/append/index.html new file mode 100644 index 0000000000..72ef52c0fb --- /dev/null +++ b/files/ja/web/api/headers/append/index.html @@ -0,0 +1,141 @@ +--- +title: Headers.append() +slug: Web/API/Headers/append +tags: + - API + - Append + - Experimental + - Fetch + - Method + - Reference +translation_of: Web/API/Headers/append +--- +

{{APIRef("Fetch")}}{{ SeeCompatTable() }}

+ +

{{domxref("Headers")}} インターフェースの append() メソッドは、Headers オブジェクト内の既存のヘッダに新しい値を追加します。または、既存のヘッダがない場合には、ヘッダを追加します。

+ +

{{domxref("Headers.set")}} と append() の違いは、特定のヘッダが既に存在して、複数の値を受け入れる場合、{{domxref("Headers.set")}} は既存の値を新しい値で上書きますが、append() は値の最後に新しい値を追加します。

+ +

セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでのみ制御できます。それらのヘッダは、{{Glossary("Forbidden_header_name", "forbidden header names", 1)}} と {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}} を含みます。

+ +

構文

+ +
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" ] を返します。
+ +

古い値を新しい値で上書きするには、{{domxref("Headers.set")}} を使います。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様ステータスコメント
{{SpecName('Fetch','#dom-headers-append','append()')}}{{Spec2('Fetch')}} 
+ +

ブラウザ実装状況

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
機能ChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
基本サポート{{ CompatChrome(42) }}
+ {{ CompatChrome(41) }} behind pref
+  		{{ CompatGeckoDesktop(39)}}
+ 34 behind pref		{{ CompatNo }} +

29
+ 28 behind pref

+ 		{{ CompatNo }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
機能AndroidFirefox Mobile (Gecko)Firefox OS (Gecko)IE PhoneOpera MobileSafari MobileChrome for Android
基本サポート{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}{{ CompatNo }}
+
+ +

関連項目

+ + -- cgit v1.2.3-54-g00ecf