diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-01-29 21:30:28 +0900 |
---|---|---|
committer | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-05 13:19:25 +0900 |
commit | 17ec9bf2609fed532bcdab7b343393c760c4f275 (patch) | |
tree | 2cad325881c1493508aca458432ae3f835393dfc | |
parent | 626b484e846bbf2d597804b9abdea3efbb9ddce2 (diff) | |
download | translated-content-17ec9bf2609fed532bcdab7b343393c760c4f275.tar.gz translated-content-17ec9bf2609fed532bcdab7b343393c760c4f275.tar.bz2 translated-content-17ec9bf2609fed532bcdab7b343393c760c4f275.zip |
2021/09/15 時点の英語版に同期
-rw-r--r-- | files/ja/web/api/xmlhttprequest/responsetype/index.md | 102 |
1 files changed, 48 insertions, 54 deletions
diff --git a/files/ja/web/api/xmlhttprequest/responsetype/index.md b/files/ja/web/api/xmlhttprequest/responsetype/index.md index 5fc67e0f19..0736e377de 100644 --- a/files/ja/web/api/xmlhttprequest/responsetype/index.md +++ b/files/ja/web/api/xmlhttprequest/responsetype/index.md @@ -5,86 +5,80 @@ tags: - AJAX - API - HTTP - - HTTP Response - - HTTP Response Type - HTTP レスポンス - - Property - - Reference - - Response + - HTTP レスポンス型 + - プロパティ + - リファレンス + - レスポンス - XHR - XMLHttpRequest - responseType - - プロパティ +browser-compat: api.XMLHttpRequest.responseType translation_of: Web/API/XMLHttpRequest/responseType --- -<div>{{APIRef('XMLHttpRequest')}}</div> +{{APIRef('XMLHttpRequest')}} -<p><span class="seoSummary">{{domxref("XMLHttpRequest")}} の <strong><code>responseType</code></strong> プロパティは、列挙型の文字列地で、レスポンスに含まれているデータの型を示します。</span>作者がレスポンスの型を変更することもできます。 <code>responseType</code> の値として空文字列が設定された場合は、既定値である <code>text</code> が使用されます。</p> +{{domxref("XMLHttpRequest")}} (XHR) の **`responseType`** プロパティは列挙型の文字列値で、レスポンスに含まれているデータの型を示します。 -<h2 id="Syntax" name="Syntax">構文</h2> +作者がレスポンスの型を変更することもできます。 `responseType` の値として空文字列が設定された場合は、既定値である `text` が使用されます。 -<pre class="syntaxbox">var <var>type</var> = <var>XMLHttpRequest</var>.responseType; +## 構文 -<var>XMLHttpRequest</var>.responseType = <var>type</var>;</pre> +```js +var type = XMLHttpRequest.responseType; -<h3 id="Value" name="Value">値</h3> +XMLHttpRequest.responseType = type; +``` -<p>文字列で、レスポンスに含まれているデータの型を指定する {{domxref("XMLHttpRequestResponseType")}} 列挙型の値を取ります。</p> +### 値 -<div class="note"> -<p><code>responseType</code> を特定の値に設定する場合は、サーバーが実際にその形式と互換性のあるレスポンスを送信していることを確認してください。サーバーが <code>responseType</code> に設定された値と互換性のないデータを返した場合、 {{domxref("XMLHttpRequest.response", "response")}} の値は <code>null</code> になります。</p> -</div> +文字列で、レスポンスに含まれているデータの型を指定します。以下の値を取ることができます。 -<p><code>responseType</code> が対応している値は以下の通りです。</p> +- `""` + - : `responseType` が空の文字列の場合は `"text"` と同じで、既定の型です。 +- `"arraybuffer"` + - : {{domxref("XMLHttpRequest.response", "response")}} はバイナリーデータを含む JavaScript の {{jsxref("ArrayBuffer")}} です。 +- `"blob"` + - : `response` はバイナリーデータを含む {{domxref("Blob")}} オブジェクトです。 +- `"document"` + - : `response` は {{Glossary("HTML")}} の {{domxref("Document")}} または {{Glossary("XML")}} の {{domxref("XMLDocument")}} で、受信したデータの MIME タイプに基づいて適切な方になります。 [XMLHttpRequest における HTML の扱い](/ja/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest)で、 XHR を使用して HTML コンテンツを読み取ることについて詳しく確認することができます。 +- `"json"` + - : `response` は {{Glossary("JSON")}} として受信したデータの内容を解釈して生成された JavaScript オブジェクトです。 +- `"text"` + - : `response` は {{domxref("DOMString")}} オブジェクトに入ったテキストです。 +- `"ms-stream"` {{non-standard_inline}} + - : `response` はストリーミングダウンロードの一部です。このレスポンス型はダウンロードリクエストでのみ利用可能で、 Internet Explorer のみが対応しています。 -<p>{{page("/ja/docs/Web/API/XMLHttpRequestResponseType", "Values")}}</p> +> **Note:** `responseType` を特定の値に設定する場合は、サーバーが実際にその形式と互換性のあるレスポンスを送信していることを確認してください。サーバーが `responseType` に設定された値と互換性のないデータを返した場合、 {{domxref("XMLHttpRequest.response", "response")}} の値は `null` になります。 +</div> -<h3 id="Exceptions" name="Exceptions">例外</h3> +### 例外 -<dl> - <dt><code>InvalidAccessError</code></dt> - <dd><code>responseType</code> の値の変更が同期モードの <code>XMLHttpRequest</code> 上で試みられたものの、 {{domxref("Worker")}} の中ではなかった場合。詳細については、下記の{{anch("Synchronous XHR restrictions", "同期 XHR の制限")}}を参照して下さい。</dd> -</dl> +- `InvalidAccessError` + - : `responseType` の値の変更が同期モードの `XMLHttpRequest` 上で試みられたものの、ワーカー ({{domxref("Worker")}}) の中ではなかった場合。詳細については、下記の{{anch("同期 XHR の制限")}}を参照してください。 -<h2 id="Usage_notes" name="Usage_notes">使用上の注意</h2> +## 使用上の注意 -<h3 id="Synchronous_XHR_restrictions" name="Synchronous_XHR_restrictions">同期 XHR の制限</h3> +### 同期 XHR の制限 -<p><code>responseType</code> の値を同期 <code>XMLHttpRequest</code> で変更することは、リクエストが {{domxref("Worker")}} に属している場合を除いてできません。この制限は、ブラウザーのメインスレッドをブロックしてユーザーの使い勝手を妨害する巨大なトランザクションが、同期操作で使用されないことを保証する対策の一環として設けられています。</p> +`responseType` の値を同期 `XMLHttpRequest` で変更することは、リクエストがワーカー ({{domxref("Worker")}}) に属している場合を除いてできません。この制限は、ブラウザーのメインスレッドをブロックしてユーザーの使い勝手を妨害する巨大なトランザクションが、同期操作で使用されないことを保証する対策の一環として設けられています。 -<p><code>XMLHttpRequest</code> は既定では非同期です。同期モードは、 <code>false</code> の値をオプションの <code>async</code> 引数に渡して {{domxref("XMLHttpRequest.open", "open()")}} ろ呼び出した場合のみ設定されます。</p> +XHR のリクエストは既定では非同期です。同期モードは、 `false` の値をオプションの `async` 引数に渡して {{domxref("XMLHttpRequest.open", "open()")}} を呼び出した場合のみ設定されます。 -<h3 id="Restrictions_in_Workers" name="Restrictions_in_Workers">Worker での制限</h3> +### ワーカーでの制限 -<p><code>responseType</code> の値を <code>document</code> に指定しようとすると、 {{domxref("Worker")}} の中では失敗します。</p> +`responseType` の値を `document` に指定しようとすると、ワーカー ({{domxref("Worker")}}) の中では失敗します。 -<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', '#the-responsetype-attribute')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>WHATWG living standard</td> - </tr> - </tbody> -</table> +{{Specifications}} -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> +## ブラウザーの互換性 -<p>{{Compat("api.XMLHttpRequest.responseType")}}</p> +{{Compat}} -<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/API/XMLHttpRequest/HTML_in_XMLHttpRequest">XMLHttpRequest 内の HTML</a></li> - <li>レスポンスデータ: {{domxref("XMLHttpRequest.response", "response")}}, {{domxref("XMLHttpRequest.responseText", "responseText")}}, {{domxref("XMLHttpRequest.responseXML", "responseXML")}}</li> -</ul> +- [XMLHttpRequest の使用](/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- [XMLHttpRequest 内の HTML](/ja/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest) +- レスポンスデータ: {{domxref("XMLHttpRequest.response", "response")}}, {{domxref("XMLHttpRequest.responseText", "responseText")}}, {{domxref("XMLHttpRequest.responseXML", "responseXML")}} |