diff options
Diffstat (limited to 'files/ja/web/api/xmlhttprequest/getresponseheader/index.md')
-rw-r--r-- | files/ja/web/api/xmlhttprequest/getresponseheader/index.md | 99 |
1 files changed, 43 insertions, 56 deletions
diff --git a/files/ja/web/api/xmlhttprequest/getresponseheader/index.md b/files/ja/web/api/xmlhttprequest/getresponseheader/index.md index 73ef9e1a35..c551c27b4c 100644 --- a/files/ja/web/api/xmlhttprequest/getresponseheader/index.md +++ b/files/ja/web/api/xmlhttprequest/getresponseheader/index.md @@ -3,47 +3,50 @@ title: XMLHttpRequest.getResponseHeader() slug: Web/API/XMLHttpRequest/getResponseHeader tags: - API + - ヘッダーの取得 - HTTP - HTTP ヘッダー - - Reference + - ヘッダー + - メソッド + - リファレンス - XHR + - XHR ヘッダー - XMLHttpRequest - getResponseHeader - - ヘッダー - - ヘッダーの取得 - - メソッド +browser-compat: api.XMLHttpRequest.getResponseHeader translation_of: Web/API/XMLHttpRequest/getResponseHeader --- -<div>{{APIRef('XMLHttpRequest')}}</div> +{{APIRef('XMLHttpRequest')}} + +{{DOMxRef("XMLHttpRequest")}} の **`getResponseHeader()`** メソッドは、特定のヘッダー値のテキストを含んだ文字列を返します。 -<p><span class="seoSummary">{{DOMxRef("XMLHttpRequest")}} の <strong><code>getResponseHeader()</code></strong> メソッドは、特定のヘッダー値のテキストを含んだ文字列を返します。</span>同じ名前で複数のレスポンスヘッダーがあった場合、値はコンマと空白で区切って値を接続した単一の文字列として返されます。 <code>getResponseHeader()</code> メソッドは値を UTF バイトシーケンスとして返します。</p> +同じ名前で複数のレスポンスヘッダーがあった場合、値はカンマと空白で区切って値を接続した単一の文字列として返されます。 `getResponseHeader()` メソッドは値を UTF バイト列として返します。 -<div class="note"> -<p><strong>メモ:</strong> ヘッダー名の検索は、大文字小文字の区別がありません。</p> -</div> +> **Note:** ヘッダー名の検索は、大文字小文字の区別がありません。 -<p>ヘッダーすべての生の文字列を取得する必要がある場合は、生のヘッダー文字列全体を返す {{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}} メソッドを使用してください。</p> +ヘッダーすべての生の文字列を取得する必要がある場合は、生のヘッダー文字列全体を返す {{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}} メソッドを使用してください。 -<h2 id="構文">構文</h2> +## 構文 -<pre class="syntaxbox">var <var>myHeader</var> = <var>XMLHttpRequest</var>.getResponseHeader(<var>headerName</var>);</pre> +```js +var myHeader = XMLHttpRequest.getResponseHeader(headerName); +``` -<h3 id="Parameters" name="Parameters">引数</h3> +### 引数 -<dl> - <dt><var>headerName</var></dt> - <dd>{{DOMxRef("ByteString")}} で、テキスト値を取得したいヘッダーの名前を示します。</dd> -</dl> +- _headerName_ + - : 文字列で、テキスト値を取得したいヘッダーの名前を示します。 -<h3 id="Return_value" name="Return_value">返値</h3> +### 返値 -<p>ヘッダーのテキスト値を表す {{DOMxRef("ByteString")}}、または、レスポンスがまだ受信されていないか、そのヘッダーがレスポンスに存在しなければ <code>null</code> です。</p> +ヘッダーのテキスト値を表す文字列、または、レスポンスがまだ受信されていないか、そのヘッダーがレスポンスに存在しなければ `null` です。 -<h2 id="Example" name="Example">例</h2> +## 例 -<p>この例では、リクエストが生成されて送信され、そして {{Event("readystatechange")}} ハンドラーを設定してヘッダーが純真で来たことを示す {{DOMxRef("XMLHttpRequest.readyState", "readyState")}} を監視します。その時が来たら、 {{httpheader("Content-Type")}} ヘッダーの値を読み取ります。 <code>Content-Type</code> が求められる値でない場合、 {{DOMxRef("XMLHttpRequest")}} は {{DOMxRef("XMLHttpRequest.abort", "abort()")}} を呼び出してキャンセルします。</p> +この例では、リクエストが生成されて送信され、そして {{domxref("XMLHttpRequest/readystatechange_event", "readystatechange")}} ハンドラーを設定してヘッダーが純真で来たことを示す {{DOMxRef("XMLHttpRequest.readyState", "readyState")}} を監視します。その時が来たら、 {{httpheader("Content-Type")}} ヘッダーの値を読み取ります。 `Content-Type` が求められる値でない場合、 {{DOMxRef("XMLHttpRequest")}} は {{DOMxRef("XMLHttpRequest.abort", "abort()")}} を呼び出してキャンセルします。 -<pre class="brush: js">var client = new XMLHttpRequest(); +```js +var client = new XMLHttpRequest(); client.open("GET", "unicorns-are-teh-awesome.txt", true); client.send(); @@ -54,37 +57,21 @@ client.onreadystatechange = function() { client.abort(); } } -}</pre> - -<h2 id="Specifications" name="Specifications">仕様書</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - <th scope="col">状態</th> - <th scope="col">備考</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("XMLHttpRequest", "#dom-xmlhttprequest-getresponseheader", "getResponseHeader()")}}</td> - <td>{{Spec2("XMLHttpRequest")}}</td> - <td>WHATWG living standard</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2> - -<div>{{Compat("api.XMLHttpRequest.getResponseHeader")}}</div> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">XMLHttpRequest の使用</a></li> - <li><a href="/ja/docs/Web/HTTP/Headers">HTTP ヘッダー</a></li> - <li>{{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}}</li> - <li>{{DOMxRef("XMLHttpRequest.response", "response")}}</li> - <li>リクエストヘッダーの設定: {{domxref("XMLHttpRequest.setRequestHeader", "setRequestHeader()")}}</li> -</ul> +} +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [XMLHttpRequest の使用](/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- [HTTP ヘッダー](/ja/docs/Web/HTTP/Headers) +- {{DOMxRef("XMLHttpRequest.getAllResponseHeaders", "getAllResponseHeaders()")}} +- {{DOMxRef("XMLHttpRequest.response", "response")}} +- リクエストヘッダーの設定: {{domxref("XMLHttpRequest.setRequestHeader", "setRequestHeader()")}} |