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/get/index.html | |
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/get/index.html')
-rw-r--r-- | files/ja/web/api/headers/get/index.html | 89 |
1 files changed, 89 insertions, 0 deletions
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> |