diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/api/headers | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/ja/web/api/headers')
-rw-r--r-- | files/ja/web/api/headers/append/index.html | 141 | ||||
-rw-r--r-- | files/ja/web/api/headers/delete/index.html | 87 | ||||
-rw-r--r-- | files/ja/web/api/headers/entries/index.html | 54 | ||||
-rw-r--r-- | files/ja/web/api/headers/get/index.html | 89 | ||||
-rw-r--r-- | files/ja/web/api/headers/headers/index.html | 73 | ||||
-rw-r--r-- | files/ja/web/api/headers/index.html | 128 |
6 files changed, 572 insertions, 0 deletions
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 +--- +<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> diff --git a/files/ja/web/api/headers/delete/index.html b/files/ja/web/api/headers/delete/index.html new file mode 100644 index 0000000000..9f85c85af3 --- /dev/null +++ b/files/ja/web/api/headers/delete/index.html @@ -0,0 +1,87 @@ +--- +title: Headers.delete() +slug: Web/API/Headers/delete +tags: + - API + - Experimental + - Fetch + - Method + - Reference + - delete +translation_of: Web/API/Headers/delete +--- +<div>{{APIRef("Fetch")}}</div> + +<p>{{domxref("Headers")}} インターフェイスの <strong><code>delete()</code></strong> メソッドは、現在の <code>Headers</code> オブジェクトからヘッダーを削除します。</p> + +<p>このメソッドは、次の理由で {{jsxref("TypeError")}} をスローします。</p> + +<ul> + <li>name パラメーターの値は、HTTP ヘッダーの名前ではありません。</li> + <li>{{Glossary("Guard")}} の値は <code>immutable</code> です。</li> +</ul> + +<p>セキュリティ上の理由から、一部のヘッダーはユーザーエージェントのみがコントローラーにすることができます。 これらのヘッダーには {{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}} および {{Glossary("Forbidden_response_header_name", "禁止レスンポンスヘッダー名", 1)}} が含まれます。</p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate"><em>myHeaders</em>.delete(<em>name</em>);</pre> + +<h3 id="引数">引数</h3> + +<dl> + <dt><code>name</code></dt> + <dd><code>Headers</code> オブジェクトから削除する HTTP ヘッダーの名前。</dd> +</dl> + +<h3 id="戻り値">戻り値</h3> + +<p>Void.</p> + +<h2 id="Example">Example</h2> + +<p>空の <code>Headers</code> オブジェクトの作成は簡単です。</p> + +<pre class="brush: js notranslate">var myHeaders = new Headers(); // Currently empty</pre> + +<p>{{domxref("Headers.append")}} を使用して、これにヘッダーを追加できます。</p> + +<pre class="brush: js notranslate">myHeaders.append('Content-Type', 'image/jpeg'); +myHeaders.get('Content-Type'); // Returns 'image/jpeg' +</pre> + +<p>その後、再度削除できます。</p> + +<pre class="brush: js notranslate">myHeaders.delete('Content-Type'); +myHeaders.get('Content-Type'); // Returns null, as it has been deleted</pre> + +<h2 id="仕様書">仕様書</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Fetch','#dom-headers-delete','delete()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.Headers.delete")}}</p> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/headers/entries/index.html b/files/ja/web/api/headers/entries/index.html new file mode 100644 index 0000000000..1899112dca --- /dev/null +++ b/files/ja/web/api/headers/entries/index.html @@ -0,0 +1,54 @@ +--- +title: Headers.entries() +slug: Web/API/Headers/entries +translation_of: Web/API/Headers/entries +--- +<div>{{APIRef}}</div> + +<p><code><strong>Headers.entries()</strong></code> メソッドは {{jsxref("Iteration_protocols",'iterator')}} を返し、このオブジェクトに含まれるすべてのキーと値のペアを通過できるようにします。各ペアのキーと値は両方とも {{domxref("ByteString")}} オブジェクトです。</p> + +<div class="注"> +<p><strong>Note</strong>: このメソッドは <a href="/docs/Web/API/Web_Workers_API">Web Workers</a> で使用できます。</p> +</div> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate">headers.entries();</pre> + +<h3 id="戻り値">戻り値</h3> + +<p>{{jsxref("Iteration_protocols","iterator")}} を返します。</p> + +<h2 id="例">例</h2> + +<pre class="brush: js;highlight:[7] notranslate">// Headers テストオブジェクトを作成 +var myHeaders = new Headers(); +myHeaders.append('Content-Type', 'text/xml'); +myHeaders.append('Vary', 'Accept-Language'); + +// キーと値のペアを表示 +for (var pair of myHeaders.entries()) { + console.log(pair[0]+ ': '+ pair[1]); +} +</pre> + +<p>結果</p> + +<pre class="notranslate">content-type: text/xml +vary: Accept-Language</pre> + +<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2> + +<div> + + +<p>{{Compat("api.Headers.entries")}}</p> +</div> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/headers/get/index.html b/files/ja/web/api/headers/get/index.html new file mode 100644 index 0000000000..cbb371c5f1 --- /dev/null +++ b/files/ja/web/api/headers/get/index.html @@ -0,0 +1,89 @@ +--- +title: Headers.get() +slug: Web/API/Headers/get +tags: + - API + - Experimental + - Fetch + - Headers + - Method + - Reference + - get +translation_of: Web/API/Headers/get +--- +<div>{{APIRef("Fetch")}}</div> + +<p>{{domxref("Headers")}} インターフェイスの <strong><code>get()</code></strong> メソッドは、指定された名前の <code>Headers</code> オブジェクト内のヘッダーのすべての値の ByteString を返します。要求されたヘッダーが <code>Headers</code> オブジェクトに存在しない場合、<code>null</code> を返します。</p> + +<p>セキュリティ上の理由から、一部のヘッダーはユーザーエージェントによってのみ制御できます。これらのヘッダーには、{{Glossary("Forbidden_header_name", "禁止ヘッダー名", 1)}} および {{Glossary("Forbidden_response_header_name", "禁止レスンポンスヘッダー名", 1)}} が含まれます。</p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox notranslate"><em>myHeaders</em>.get(<em>name</em>);</pre> + +<h3 id="引数">引数</h3> + +<dl> + <dt><code>name</code></dt> + <dd><code>Headers</code> オブジェクトから値を取得する HTTP ヘッダーの名前。指定された名前が HTTP ヘッダーの名前でない場合、このメソッドは {{jsxref("TypeError")}} を返します。名前は大文字と小文字を区別しません。</dd> +</dl> + +<h3 id="戻り値">戻り値</h3> + +<p>取得したヘッダーの値を表す {{domxref("ByteString")}} シーケンス。このヘッダーが設定されていない場合は <code>null</code> を返します。</p> + +<h2 id="例">例</h2> + +<p>空の <code>Headers</code> オブジェクトの作成は簡単です。</p> + +<pre class="brush: js notranslate">var myHeaders = new Headers(); // 現在空です +myHeaders.get('Not-Set'); // null を返します +</pre> + +<p>{{domxref("Headers.append")}} を使用してヘッダーを追加し、<code>get()</code> を使用してヘッダーを取得できます。</p> + +<pre class="brush: js notranslate">myHeaders.append('Content-Type', 'image/jpeg'); +myHeaders.get('Content-Type'); // "image/jpeg" を返します +</pre> + +<p>ヘッダーに複数の値が関連付けられている場合、ByteString には、<code>Headers</code> オブジェクトに追加された順序ですべての値が含まれます。</p> + +<pre class="brush: js notranslate">myHeaders.append('Accept-Encoding', 'deflate'); +myHeaders.append('Accept-Encoding', 'gzip'); +myHeaders.get('Accept-Encoding'); // "deflate,gzip" を返します +</pre> + +<div class="note"> +<p><strong>注</strong>: {{domxref("Headers.getAll")}} にはこの機能があり、{{domxref("Headers.get")}} は <code>Headers</code> オブジェクトに追加された最初の値のみを返します。最新の仕様では <code>getAll()</code> が削除され、すべての値を返すように <code>get()</code> が更新されました。</p> +</div> + +<h2 id="仕様書">仕様書</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Fetch','#dom-headers-get','get()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザーの互換性">ブラウザーの互換性</h2> + + + +<p>{{Compat("api.Headers.get")}}</p> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/headers/headers/index.html b/files/ja/web/api/headers/headers/index.html new file mode 100644 index 0000000000..d143c50f7b --- /dev/null +++ b/files/ja/web/api/headers/headers/index.html @@ -0,0 +1,73 @@ +--- +title: Headers() +slug: Web/API/Headers/Headers +translation_of: Web/API/Headers/Headers +--- +<div>{{APIRef("Fetch")}}</div> + +<p><code><strong>Headers()</strong></code><strong> </strong>コンストラクターは新しい {{domxref("Headers")}} オブジェクトを生成します。</p> + +<h2 id="文法">文法</h2> + +<pre class="syntaxbox notranslate">var <em>myHeaders</em> = new Headers(<em>init</em>);</pre> + +<h3 id="引数">引数</h3> + +<dl> + <dt><code>init</code> {{optional_inline}}</dt> + <dd><code>Headers</code> に前もって設定したい <a href="/en-US/docs/Web/HTTP/Headers">HTTP headers</a> を含むオブジェクト。これは {{domxref("ByteString")}} を持つ単純なオブジェクトリテラルか、既存の <code>Headers</code> オブジェクトのどちらかです。最後の例では、新しい <code>Headers</code> オブジェクトは既存の <code>Headers</code> オブジェクトからデータを継承します。</dd> +</dl> + +<h2 id="例">例</h2> + +<p>簡単に空の <code>Headers</code> オブジェクトを生成できます。</p> + +<pre class="brush: js notranslate">var myHeaders = new Headers(); // Currently empty</pre> + +<p>{{domxref("Headers.append")}} を使用してヘッダーを追加できます。</p> + +<pre class="brush: js notranslate">myHeaders.append('Content-Type', 'image/jpeg'); +myHeaders.get('Content-Type'); // Returns 'image/jpeg' +</pre> + +<p>または、<code>Headers</code> オブジェクトの生成時に必要なヘッダーを追加することもできます。次のスニペットでは、新しい {{domxref("Headers")}} を作成し、コンストラクターに init オブジェクトを引数として渡してヘッダーを追加しています。</p> + +<pre class="brush: js notranslate">var httpHeaders = { 'Content-Type' : 'image/jpeg', 'Accept-Charset' : 'utf-8', 'X-My-Custom-Header' : 'Zeke are cool' }; +var myHeaders = new Headers(httpHeaders);</pre> + +<p>最初の <code>Headers</code> を init オブジェクトとして渡して、別の <code>Headers</code> オブジェクトを生成できます。</p> + +<pre class="brush: js notranslate">var secondHeadersObj = new Headers(myHeaders); +secondHeadersObj.get('Content-Type'); // Would return 'image/jpeg' — it inherits it from the first headers object</pre> + +<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','Headers()')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザの対応">ブラウザの対応</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p><br> + {{Compat("api.Headers.headers")}}</p> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/ServiceWorker_API">サービスワーカー API</a></li> + <li><a href="/docs/Web/HTTP/Access_control_CORS">HTTP アクセス制御 (CORS)</a></li> + <li><a href="/docs/Web/HTTP">HTTP</a></li> +</ul> diff --git a/files/ja/web/api/headers/index.html b/files/ja/web/api/headers/index.html new file mode 100644 index 0000000000..ba3dea6c65 --- /dev/null +++ b/files/ja/web/api/headers/index.html @@ -0,0 +1,128 @@ +--- +title: Headers +slug: Web/API/Headers +tags: + - API + - Experimental + - Fetch + - Fetch API + - Headers + - Interface + - Reference +translation_of: Web/API/Headers +--- +<p>{{ APIRef("Fetch") }}</p> + +<p><a href="/ja/docs/Web/API/Fetch_API">Fetch API</a> の <strong><code>Headers</code></strong> インターフェースは、HTTP リクエストとレスポンスのヘッダ上のさまざまなアクションを実行します。これらのアクションには、取得や設定、追加、削除が含まれます。<code>Headers</code> オブジェクトは、最初は空で 0 個以上の名前と値のペアで構成される関連するヘッダリストを持っています。<span style="line-height: 19.0909080505371px;">追加には {{domxref("Headers.append","append()")}}({{anch("例")}} を見てください)のようなメソッドを使用できます。</span>このインタフェースのすべてのメソッドで、ヘッダ名は大文字と小文字を区別しないバイトシーケンスにマッチしています。</p> + +<p>セキュリティ上の理由から、いくつかのヘッダはユーザーエージェントでしか制御できません。それらのヘッダには、{{Glossary("Forbidden_header_name", "forbidden header names", 1)}} と {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}} が含まれます。</p> + +<p>ヘッダは関連するガードも持っています。ガードは <code>immutable</code> か <code>request</code>、<code>request-no-cors</code>、<code>response</code>、<code>none</code> のいずれかの値を取ります。これはヘッダを変更する {{domxref("Headers.set","set()")}} メソッドと {{domxref("Headers.delete","delete()")}} メソッド、{{domxref("Headers.append","append()")}} メソッドに影響を与えます。詳細は {{Glossary("Guard")}} を見てください。</p> + +<p>{{domxref("Request.headers")}} プロパティと {{domxref("Response.headers")}} プロパティ経由で <code>Headers</code> オブジェクトを取得することも、{{domxref("Headers.Headers()")}} コンストラクタを使用して新しい <code>Headers</code> オブジェクトを生成することもできます。</p> + +<p><code>Headers</code> を実装したオブジェクトは、{{domxref('Headers.entries()', 'entries()')}} の代わりに直接 {{jsxref("Statements/for...of", "for...of")}} 構文で使用できます: <code>for (var p of myHeaders)</code> と <code>for (var p of myHeaders.entries())</code> は同等です。</p> + +<div class="note"> +<p><strong>ノート</strong>: 利用できるヘッダについては<a href="/ja/docs/Web/HTTP/Headers">HTTP ヘッダ</a> を参照してください。</p> +</div> + +<h2 id="コンストラクタ">コンストラクタ</h2> + +<dl> + <dt>{{domxref("Headers.Headers()")}}</dt> + <dd>新しい <code>Headers</code> オブジェクトを生成する。</dd> +</dl> + +<h2 id="メソッド">メソッド</h2> + +<dl> + <dt>{{domxref("Headers.append()")}}</dt> + <dd><code>Headers</code> オブジェクト内の既存のヘッダに新しい値を追加するか、まだ存在しない場合はヘッダを追加する。</dd> + <dt>{{domxref("Headers.delete()")}}</dt> + <dd><code>Headers</code> オブジェクトからヘッダを削除する。</dd> + <dt>{{domxref("Headers.entries()")}}</dt> + <dd>このオブジェクトに含まれるすべてのキー/値 ペアを通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。</dd> + <dt>{{domxref("Headers.get()")}}</dt> + <dd><code>Headers</code> オブジェクト内から指定したヘッダのすべての値の {{domxref("ByteString")}} を返す。</dd> + <dt>{{domxref("Headers.has()")}}</dt> + <dd><code>Headers</code> オブジェクトが特定のヘッダを含むかどうかを示す boolean 値を返す。</dd> + <dt>{{domxref("Headers.keys()")}}</dt> + <dd>このオブジェクトに含まれるキー/値 ペアのすべてのキーを通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。</dd> + <dt>{{domxref("Headers.set()")}}</dt> + <dd>オブジェクト内の既存のヘッダに新しい値を設定するか、まだ存在しない場合はヘッダを追加する。</dd> + <dt>{{domxref("Headers.values()")}}</dt> + <dd>このオブジェクトに含まれるキー/値 ペアのすべての値を通して処理するための {{jsxref("Iteration_protocols","iterator")}} を返す。</dd> +</dl> + +<div class="note"> +<p><strong>ノート</strong>: {{domxref("Headers.set()")}} と {{domxref("Headers.append()")}} の明確な違いは、複数の値を受け入れる特定のヘッダが既に存在しているときの挙動です。{{domxref("Headers.set()")}} は既存の値を新しい値で上書きしますが、{{domxref("Headers.append()")}} は既存の値の末尾に新しい値を追加します。サンプルコードはそれぞれの専用ページで確認してください。</p> +</div> + +<div class="note"> +<p><strong>ノート</strong>: <a href="https://fetch.spec.whatwg.org/#concept-header-name">有効な HTTP ヘッダ名</a> ではない名前の参照を渡そうとすると、すべての Headers メソッドは <code>TypeError</code> をスローします。ヘッダに immutable {{Glossary("Guard")}} がある場合、変更操作は <code>TypeError</code> をスローします。そのほかの場外の場合は、単にに失敗します。</p> +</div> + +<div class="note"> +<p><strong>ノート</strong>:ヘッダーをイテレートする時、自動的に辞書順への並び替えが行われ、重複する名前は結合されます。</p> +</div> + +<h3 id="廃止になった機能">廃止になった機能</h3> + +<dl> + <dt>{{domxref("Headers.getAll()")}}</dt> + <dd><code>Headers</code> オブジェクト内で指定されたヘッダのすべての値を配列として返す。このメソッドは規格から削除されており、 {{domxref("Headers.get()")}} は現在では与えられた名前に一致する最初のものを返します。</dd> +</dl> + +<h2 id="例">例</h2> + +<p>次のコードスニペットでは、<code>Headers()</code> コンストラクタを使用して新しいヘッダを生成し、<code>append()</code> を使用して新しいヘッダを追加しています。その後、<code>get()</code> を使用してヘッダの値を返しています:</p> + +<pre class="brush: js notranslate">var myHeaders = new Headers(); + +myHeaders.append('Content-Type', 'text/xml'); +myHeaders.get('Content-Type') // 'text/xml' を返す。</pre> + +<p>同じことがコンストラクタにオブジェクトリテラルか配列リテラルの配列リテラルを渡すことでできます。</p> + +<pre class="brush: js notranslate">var myHeaders = new Headers({ + 'Content-Type': 'text/xml' +}); + +// or, using an array of arrays: +myHeaders = new Headers([ + ['Content-Type', 'text/xml'] +]); + +myHeaders.get('Content-Type') // should return 'text/xml'</pre> + +<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','#headers-class','Headers')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2> + + + +<p>{{Compat("api.Headers")}}</p> + +<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> |