From a1ee3f2a799e2e2c9fe9bb9247e3c6067bbf0b26 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 29 Jan 2022 22:15:01 +0900 Subject: 2021/09/15 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/xmlhttprequest/response/index.md | 83 ++++++++--------------- 1 file changed, 30 insertions(+), 53 deletions(-) (limited to 'files') diff --git a/files/ja/web/api/xmlhttprequest/response/index.md b/files/ja/web/api/xmlhttprequest/response/index.md index 76e5e90fa3..f4cd6f354c 100644 --- a/files/ja/web/api/xmlhttprequest/response/index.md +++ b/files/ja/web/api/xmlhttprequest/response/index.md @@ -4,48 +4,43 @@ slug: Web/API/XMLHttpRequest/response tags: - AJAX - API - - Content - - Fetching - - Fetching Data - - Loading Data - - Property - - Read-only + - コンテンツの読み取り + - データの読み取り + - データの読み込み + - プロパティ + - 読み取り専用 - Reading Data - - Reference + - リファレンス - Response - - Server + - サーバー - XMLHttpRequest translation_of: Web/API/XMLHttpRequest/response --- -
{{APIRef('XMLHttpRequest')}}
+{{APIRef('XMLHttpRequest')}} -

{{domxref("XMLHttpRequest")}} response プロパティは、そのリクエストの{{domxref("responseType")}}によって、{{domxref("ArrayBuffer")}}, {{domxref("Blob")}}, {{domxref("Document")}}, JavaScript {{jsxref("Object")}}, or {{domxref("DOMString")}}といったレスポンスのボディを返します。

+{{domxref("XMLHttpRequest")}} の **`response`** プロパティは、そのリクエストの本文の内容を、 {{jsxref("ArrayBuffer")}}, {{domxref("Blob")}}, {{domxref("Document")}}, JavaScript の {{jsxref("Object")}}, {{domxref("DOMString")}} など、リクエストの {{domxref("XMLHttpRequest.responseType", "responseType")}} プロパティの値に応じた形で返します。 -

構文

+## 構文 -
var body = XMLHttpRequest.response;
-
+```js +var body = XMLHttpRequest.response; +``` -

値

+### 値 -

{{domxref("XMLHttpRequest.responseType", "responseType")}}の値に基づく適切なオブジェクト。 {{domxref("XMLHttpRequest.open", "open()")}}を呼び出してリクエストを初期化した後や、{{domxref("XMLHttpRequest.send", "send()")}}を呼び出してリクエストをサーバーに送信する前に、responseTypeの値を設定することで、特定の形式でデータを提供するようにリクエストができます。

+{{domxref("XMLHttpRequest.responseType", "responseType")}} の値に基づく適切なオブジェクト。 {{domxref("XMLHttpRequest.open", "open()")}} を呼び出してリクエストを初期化した後や、 {{domxref("XMLHttpRequest.send", "send()")}} を呼び出してリクエストをサーバーに送信する前に、 `responseType` の値を設定することで、特定の形式でデータを提供するようにリクエストができます。 -

リクエストが未完了または失敗する場合、値はnullです。ただし、"text"や空の文字列である("")を使用してテキストデータを読み込む場合は除きます。リクエストがまだLOADING {{domxref("XMLHttpRequest.readyState", "readyState")}} (3)にある間、レスポンスはこれまでのレスポンスを含むことがあります。

+リクエストが未完了または失敗する場合、値は `null` です。ただし、 `"text"` や空の文字列 (`""`) を使用してテキストデータを読み込む場合は除きます。リクエストがまだ `LOADING` {{domxref("XMLHttpRequest.readyState", "readyState")}} (3) にある間、レスポンスはこれまでのレスポンスを含むことがあります。 -

レスポンスタイプは以下のとおりです。

+## 例 -

{{page("/en-US/docs/Web/API/XMLHttpRequestResponseType", "Values")}}

+この例で紹介している `load()` 関数は、サーバーからページを読み込み処理するものです。これは、 {{domxref("XMLHttpRequest")}} オブジェクトを作成し、 {{domxref("XMLHttpRequest/readystatechange_event", "readystatechange")}} イベントのリスナーを生成して、その中で `readyState` イベントが `DONE` (4) に変わると `response` が取得し、 `load()` に渡されたコールバック関数に渡しています。 -
-
+コンテンツは生のテキストデータとして扱われます（ここでは、既定の +{{domxref("XMLHttpRequest.responseType", "responseType")}} を上書きするものがないため）。 -

例

- -

下記に、サーバーからページをロードして処理する関数load()を例として提示します。仕組みとしては、XMLHttpRequestオブジェクトを作成し、{{event("readystatechange")}}イベントのリスナー（readyStateイベントがDONE （4）に変わるとresponseが取得され、それをload()のコールバック関数に渡すといった）を作成しています。

- -

コンテンツは生のテキストデータとして処理されます（デフォルトの{{domxref("XMLHttpRequest.responseType", "responseType")}}を上書きするものは何もないため）。

- -
var url = 'somePage.html'; //A local page
+```js
+var url = 'somePage.html'; //A local page
 
 function load(url, callback) {
   var xhr = new XMLHttpRequest();
@@ -59,35 +54,17 @@ function load(url, callback) {
   xhr.open('GET', url, true);
   xhr.send('');
 }
+```
 
-
- -

仕様書

- - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#the-response-attribute')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザの対応

+## 仕様書 +{{Specifications}} +## ブラウザーの互換性 -

{{Compat("api.XMLHttpRequest.response")}}

+{{Compat}} -

関連

+## 関連情報 - +- [XMLHttpRequest の使用](/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) +- テキストと HTML/XML データの取得: {{domxref("XMLHttpRequest.responseText")}} および {{domxref("XMLHttpRequest.responseXML")}} -- cgit v1.2.3-54-g00ecf