blob: 72ef52c0fbd65a4f44ce2f029df12b3c3c9a3a63 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
---
title: Headers.append()
slug: Web/API/Headers/append
tags:
- API
- Append
- Experimental
- Fetch
- Method
- Reference
translation_of: Web/API/Headers/append
---
<p>{{APIRef("Fetch")}}{{ SeeCompatTable() }}</p>
<p>{{domxref("Headers")}} インターフェースの <strong><code>append()</code></strong> メソッドは、<code>Headers</code> オブジェクト内の既存のヘッダに新しい値を追加します。または、既存のヘッダがない場合には、ヘッダを追加します。</p>
<p>{{domxref("Headers.set")}} と <code>append()</code> の違いは、特定のヘッダが既に存在して、複数の値を受け入れる場合、{{domxref("Headers.set")}} は既存の値を新しい値で上書きますが、<code>append()</code> は値の最後に新しい値を追加します。</p>
<p style="line-height: 19.0909080505371px;">セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでのみ制御できます。それらのヘッダは、{{Glossary("Forbidden_header_name", "forbidden header names", 1)}} と {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}} を含みます。</p>
<h2 id="構文">構文</h2>
<pre class="brush: js">myHeaders.append(name,value);</pre>
<h3 id="パラメータ">パラメータ</h3>
<dl>
<dt><em>name</em></dt>
<dd><code>Headers</code> オブジェクトに追加する HTTP ヘッダ名。</dd>
<dt><em>value</em></dt>
<dd>HTTP ヘッダに追加する値。</dd>
</dl>
<h3 id="戻り値">戻り値</h3>
<p>Void。</p>
<h2 id="例">例</h2>
<p>空の <code>Headers</code> オブジェクトの生成はシンプルです：</p>
<pre class="brush: js">var myHeaders = new Headers(); // 現在は空</pre>
<p><code>append()</code> を使用してヘッダを追加できます：</p>
<pre>myHeaders.append('Content-Type', 'image/jpeg');
myHeaders.get('Content-Type'); // 'image/jpeg' を返します。
</pre>
<p>特定のヘッダが既に存在する場合、<code>append()</code> はその値を指定した値に変更します。特定のヘッダが既に存在して複数の値を受け入れる場合、<code>append()</code> は値の末尾に新しい値を追加します：</p>
<pre class="brush: js">myHeaders.append('Accept-Encoding', 'deflate');
myHeaders.append('Accept-Encoding', 'gzip');
myHeaders.getAll('Accept-Encoding'); // [ "deflate", "gzip" ] を返します。</pre>
<p>古い値を新しい値で上書きするには、{{domxref("Headers.set")}} を使います。</p>
<h2 id="仕様">仕様</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">仕様</th>
<th scope="col">ステータス</th>
<th scope="col">コメント</th>
</tr>
<tr>
<td>{{SpecName('Fetch','#dom-headers-append','append()')}}</td>
<td>{{Spec2('Fetch')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>機能</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari (WebKit)</th>
</tr>
<tr>
<td>基本サポート</td>
<td>{{ CompatChrome(42) }}<br>
{{ CompatChrome(41) }} behind pref<br>
</td>
<td>{{ CompatGeckoDesktop(39)}}<br>
34 behind pref</td>
<td>{{ CompatNo }}</td>
<td>
<p>29<br>
28 behind pref</p>
</td>
<td>{{ CompatNo }}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>機能</th>
<th>Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>Firefox OS (Gecko)</th>
<th>IE Phone</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
<th>Chrome for Android</th>
</tr>
<tr>
<td>基本サポート</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
<td>{{ CompatNo }}</td>
</tr>
</tbody>
</table>
</div>
<h2 id="関連項目">関連項目</h2>
<ul>
<li><a href="/ja/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li>
<li><a href="/ja/docs/Web/HTTP/Access_control_CORS">HTTP アクセス制御 (CORS)</a></li>
<li><a href="/ja/docs/Web/HTTP">HTTP</a></li>
</ul>
|
