From 3209b4d4ad9db0c919bdf60c01c219845fe5a250 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 29 Jan 2022 01:41:41 +0900 Subject: XMLHttpRequest のプロパティの記事を移行 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/xmlhttprequest/channel/index.html | 19 ---- files/ja/web/api/xmlhttprequest/channel/index.md | 19 ++++ files/ja/web/api/xmlhttprequest/mozanon/index.html | 18 ---- files/ja/web/api/xmlhttprequest/mozanon/index.md | 18 ++++ .../xmlhttprequest/mozbackgroundrequest/index.html | 28 ------ .../xmlhttprequest/mozbackgroundrequest/index.md | 28 ++++++ .../ja/web/api/xmlhttprequest/mozsystem/index.html | 18 ---- files/ja/web/api/xmlhttprequest/mozsystem/index.md | 18 ++++ .../xmlhttprequest/onreadystatechange/index.html | 77 --------------- .../api/xmlhttprequest/onreadystatechange/index.md | 77 +++++++++++++++ .../web/api/xmlhttprequest/readystate/index.html | 107 --------------------- .../ja/web/api/xmlhttprequest/readystate/index.md | 107 +++++++++++++++++++++ .../ja/web/api/xmlhttprequest/response/index.html | 93 ------------------ files/ja/web/api/xmlhttprequest/response/index.md | 93 ++++++++++++++++++ .../web/api/xmlhttprequest/responsetext/index.html | 81 ---------------- .../web/api/xmlhttprequest/responsetext/index.md | 81 ++++++++++++++++ .../web/api/xmlhttprequest/responsetype/index.html | 90 ----------------- .../web/api/xmlhttprequest/responsetype/index.md | 90 +++++++++++++++++ .../web/api/xmlhttprequest/responseurl/index.html | 48 --------- .../ja/web/api/xmlhttprequest/responseurl/index.md | 48 +++++++++ .../web/api/xmlhttprequest/responsexml/index.html | 107 --------------------- .../ja/web/api/xmlhttprequest/responsexml/index.md | 107 +++++++++++++++++++++ files/ja/web/api/xmlhttprequest/status/index.html | 78 --------------- files/ja/web/api/xmlhttprequest/status/index.md | 78 +++++++++++++++ files/ja/web/api/xmlhttprequest/timeout/index.html | 66 ------------- files/ja/web/api/xmlhttprequest/timeout/index.md | 66 +++++++++++++ files/ja/web/api/xmlhttprequest/upload/index.html | 103 -------------------- files/ja/web/api/xmlhttprequest/upload/index.md | 103 ++++++++++++++++++++ 28 files changed, 933 insertions(+), 933 deletions(-) delete mode 100644 files/ja/web/api/xmlhttprequest/channel/index.html create mode 100644 files/ja/web/api/xmlhttprequest/channel/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/mozanon/index.html create mode 100644 files/ja/web/api/xmlhttprequest/mozanon/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.html create mode 100644 files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/mozsystem/index.html create mode 100644 files/ja/web/api/xmlhttprequest/mozsystem/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/onreadystatechange/index.html create mode 100644 files/ja/web/api/xmlhttprequest/onreadystatechange/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/readystate/index.html create mode 100644 files/ja/web/api/xmlhttprequest/readystate/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/response/index.html create mode 100644 files/ja/web/api/xmlhttprequest/response/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/responsetext/index.html create mode 100644 files/ja/web/api/xmlhttprequest/responsetext/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/responsetype/index.html create mode 100644 files/ja/web/api/xmlhttprequest/responsetype/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/responseurl/index.html create mode 100644 files/ja/web/api/xmlhttprequest/responseurl/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/responsexml/index.html create mode 100644 files/ja/web/api/xmlhttprequest/responsexml/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/status/index.html create mode 100644 files/ja/web/api/xmlhttprequest/status/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/timeout/index.html create mode 100644 files/ja/web/api/xmlhttprequest/timeout/index.md delete mode 100644 files/ja/web/api/xmlhttprequest/upload/index.html create mode 100644 files/ja/web/api/xmlhttprequest/upload/index.md (limited to 'files') diff --git a/files/ja/web/api/xmlhttprequest/channel/index.html b/files/ja/web/api/xmlhttprequest/channel/index.html deleted file mode 100644 index 432e55c33a..0000000000 --- a/files/ja/web/api/xmlhttprequest/channel/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: XMLHttpRequest.channel -slug: Web/API/XMLHttpRequest/channel -tags: - - API - - Non-standard - - Property - - Reference - - XHR - - XMLHttpRequest - - channel - - nsIChannel - - プロパティ - - リファレンス -translation_of: Web/API/XMLHttpRequest/channel ---- -

{{draft}}{{APIRef('XMLHttpRequest')}}

- -

XMLHttpRequest.channel は リクエストを送信するときにオブジェクトによって使用されるnsIChannel です。channelがまだ作られていない場合、これは null です。マルチパートリクエストのときは、これは最初のchannelであり、マルチパートリクエストの異なるパートのことではありません。アクセスするには、権限昇格が必要です。

diff --git a/files/ja/web/api/xmlhttprequest/channel/index.md b/files/ja/web/api/xmlhttprequest/channel/index.md new file mode 100644 index 0000000000..432e55c33a --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/channel/index.md @@ -0,0 +1,19 @@ +--- +title: XMLHttpRequest.channel +slug: Web/API/XMLHttpRequest/channel +tags: + - API + - Non-standard + - Property + - Reference + - XHR + - XMLHttpRequest + - channel + - nsIChannel + - プロパティ + - リファレンス +translation_of: Web/API/XMLHttpRequest/channel +--- +

{{draft}}{{APIRef('XMLHttpRequest')}}

+ +

XMLHttpRequest.channel は リクエストを送信するときにオブジェクトによって使用されるnsIChannel です。channelがまだ作られていない場合、これは null です。マルチパートリクエストのときは、これは最初のchannelであり、マルチパートリクエストの異なるパートのことではありません。アクセスするには、権限昇格が必要です。

diff --git a/files/ja/web/api/xmlhttprequest/mozanon/index.html b/files/ja/web/api/xmlhttprequest/mozanon/index.html deleted file mode 100644 index 89076289f2..0000000000 --- a/files/ja/web/api/xmlhttprequest/mozanon/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: XMLHttpRequest.mozAnon -slug: Web/API/XMLHttpRequest/mozAnon -tags: - - API - - Property - - Reference - - XHR - - XMLHttpRequest - - cookie - - mozAnon - - 認証 - - 非標準 -translation_of: Web/API/XMLHttpRequest/mozAnon ---- -
{{draft}}{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.mozAnon はブール値です。 true の場合、リクエストは Cookie または認証ヘッダなしで送信されます。

diff --git a/files/ja/web/api/xmlhttprequest/mozanon/index.md b/files/ja/web/api/xmlhttprequest/mozanon/index.md new file mode 100644 index 0000000000..89076289f2 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/mozanon/index.md @@ -0,0 +1,18 @@ +--- +title: XMLHttpRequest.mozAnon +slug: Web/API/XMLHttpRequest/mozAnon +tags: + - API + - Property + - Reference + - XHR + - XMLHttpRequest + - cookie + - mozAnon + - 認証 + - 非標準 +translation_of: Web/API/XMLHttpRequest/mozAnon +--- +
{{draft}}{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.mozAnon はブール値です。 true の場合、リクエストは Cookie または認証ヘッダなしで送信されます。

diff --git a/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.html b/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.html deleted file mode 100644 index 7be9f73f24..0000000000 --- a/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: XMLHttpRequest.mozBackgroundRequest -slug: Web/API/XMLHttpRequest/mozBackgroundRequest -tags: - - API - - Background Service - - Mozilla - - Non-standard - - Property - - Reference - - XHR - - XMLHttpRequest - - mozBackgroundRequest -translation_of: Web/API/XMLHttpRequest/mozBackgroundRequest ---- -

{{draft}}{{APIRef('XMLHttpRequest')}}

- -
-

Note: このメソッドは、 Web コンテンツから使用できません。アクセスするには管理者特権が必要です。

-
- -

XMLHttpRequest.mozBackgroundRequest はブール値で、オブジェクトがバックグラウンドサービスリクエストを表すかどうかを示します。  true の場合、要求に関連付けられているロードグループはなく、セキュリティダイアログはユーザーに表示されません。

- -

通常、セキュリティダイアログ (認証や不正な証明書通知など) が表示される場合、この要求は失敗します。

- -
-

Note: このプロパティは、 open() を呼び出す前に設定する必要があります。

-
diff --git a/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.md b/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.md new file mode 100644 index 0000000000..7be9f73f24 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/mozbackgroundrequest/index.md @@ -0,0 +1,28 @@ +--- +title: XMLHttpRequest.mozBackgroundRequest +slug: Web/API/XMLHttpRequest/mozBackgroundRequest +tags: + - API + - Background Service + - Mozilla + - Non-standard + - Property + - Reference + - XHR + - XMLHttpRequest + - mozBackgroundRequest +translation_of: Web/API/XMLHttpRequest/mozBackgroundRequest +--- +

{{draft}}{{APIRef('XMLHttpRequest')}}

+ +
+

Note: このメソッドは、 Web コンテンツから使用できません。アクセスするには管理者特権が必要です。

+
+ +

XMLHttpRequest.mozBackgroundRequest はブール値で、オブジェクトがバックグラウンドサービスリクエストを表すかどうかを示します。  true の場合、要求に関連付けられているロードグループはなく、セキュリティダイアログはユーザーに表示されません。

+ +

通常、セキュリティダイアログ (認証や不正な証明書通知など) が表示される場合、この要求は失敗します。

+ +
+

Note: このプロパティは、 open() を呼び出す前に設定する必要があります。

+
diff --git a/files/ja/web/api/xmlhttprequest/mozsystem/index.html b/files/ja/web/api/xmlhttprequest/mozsystem/index.html deleted file mode 100644 index 6915ecc5c6..0000000000 --- a/files/ja/web/api/xmlhttprequest/mozsystem/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: XMLHttpRequest.mozSystem -slug: Web/API/XMLHttpRequest/mozSystem -tags: - - AP - - Non-standard - - Property - - Reference - - XHR - - XMLHttpRequest - - ame Origin Policy - - mozSystem - - origin -translation_of: Web/API/XMLHttpRequest/mozSystem ---- -
{{draft}}{{APIRef('XMLHttpRequest')}}
- -

mozSystem はブール値です。 true の場合、同じ発信元ポリシーはリクエストに適用されません。

diff --git a/files/ja/web/api/xmlhttprequest/mozsystem/index.md b/files/ja/web/api/xmlhttprequest/mozsystem/index.md new file mode 100644 index 0000000000..6915ecc5c6 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/mozsystem/index.md @@ -0,0 +1,18 @@ +--- +title: XMLHttpRequest.mozSystem +slug: Web/API/XMLHttpRequest/mozSystem +tags: + - AP + - Non-standard + - Property + - Reference + - XHR + - XMLHttpRequest + - ame Origin Policy + - mozSystem + - origin +translation_of: Web/API/XMLHttpRequest/mozSystem +--- +
{{draft}}{{APIRef('XMLHttpRequest')}}
+ +

mozSystem はブール値です。 true の場合、同じ発信元ポリシーはリクエストに適用されません。

diff --git a/files/ja/web/api/xmlhttprequest/onreadystatechange/index.html b/files/ja/web/api/xmlhttprequest/onreadystatechange/index.html deleted file mode 100644 index 69b8213d0e..0000000000 --- a/files/ja/web/api/xmlhttprequest/onreadystatechange/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: XMLHttpRequest.onreadystatechange -slug: Web/API/XMLHttpRequest/onreadystatechange -tags: - - API - - Event - - Reference - - XHR - - XMLHttpRequest - - onreadystatechange - - readyState - - イベント - - ハンドラー - - プロパティ -translation_of: Web/API/XMLHttpRequest/onreadystatechange ---- -
{{APIRef}}
- -

{{event("Event_handlers", "event handler")}} で、 readyState 属性が変化するたびに呼び出されます。コールバックはユーザーインターフェイスのスレッドから呼び出されます。 XMLHttpRequest.onreadystatechange プロパティは、 {{domxref("Document/readystatechange_event", "readystatechange")}} イベントが発生するたびに、つまり {{domxref("XMLHttpRequest")}} の {{domxref("XMLHttpRequest.readyState", "readyState")}} が変化するたびに呼び出されるイベントハンドラーを保持します。

- -
-

警告: これは同期要求で使用してはいけません。また、ネイティブコードから使用してはいけません。

-
- -

構文

- -
XMLHttpRequest.onreadystatechange = callback;
- -

値

- - - -

例

- -
const xhr = new XMLHttpRequest(),
-    method = "GET",
-    url = "https://developer.mozilla.org/";
-
-xhr.open(method, url, true);
-xhr.onreadystatechange = function () {
-  // ローカルファイルでは、 Mozilla Firefox で成功するとステータスは0になります
-  if(xhr.readyState === XMLHttpRequest.DONE) {
-    var status = xhr.status;
-    if (status === 0 || (status >= 200 && status < 400)) {
-      // リクエストが正常に終了した
-      console.log(xhr.responseText);
-    } else {
-      // あらら! リクエストでエラーが発生しました!
-    }
-  }
-};
-xhr.send();
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('XMLHttpRequest', '#handler-xhr-onreadystatechange')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザーの互換性

- -

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

diff --git a/files/ja/web/api/xmlhttprequest/onreadystatechange/index.md b/files/ja/web/api/xmlhttprequest/onreadystatechange/index.md new file mode 100644 index 0000000000..69b8213d0e --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/onreadystatechange/index.md @@ -0,0 +1,77 @@ +--- +title: XMLHttpRequest.onreadystatechange +slug: Web/API/XMLHttpRequest/onreadystatechange +tags: + - API + - Event + - Reference + - XHR + - XMLHttpRequest + - onreadystatechange + - readyState + - イベント + - ハンドラー + - プロパティ +translation_of: Web/API/XMLHttpRequest/onreadystatechange +--- +
{{APIRef}}
+ +

{{event("Event_handlers", "event handler")}} で、 readyState 属性が変化するたびに呼び出されます。コールバックはユーザーインターフェイスのスレッドから呼び出されます。 XMLHttpRequest.onreadystatechange プロパティは、 {{domxref("Document/readystatechange_event", "readystatechange")}} イベントが発生するたびに、つまり {{domxref("XMLHttpRequest")}} の {{domxref("XMLHttpRequest.readyState", "readyState")}} が変化するたびに呼び出されるイベントハンドラーを保持します。

+ +
+

警告: これは同期要求で使用してはいけません。また、ネイティブコードから使用してはいけません。

+
+ +

構文

+ +
XMLHttpRequest.onreadystatechange = callback;
+ +

値

+ + + +

例

+ +
const xhr = new XMLHttpRequest(),
+    method = "GET",
+    url = "https://developer.mozilla.org/";
+
+xhr.open(method, url, true);
+xhr.onreadystatechange = function () {
+  // ローカルファイルでは、 Mozilla Firefox で成功するとステータスは0になります
+  if(xhr.readyState === XMLHttpRequest.DONE) {
+    var status = xhr.status;
+    if (status === 0 || (status >= 200 && status < 400)) {
+      // リクエストが正常に終了した
+      console.log(xhr.responseText);
+    } else {
+      // あらら! リクエストでエラーが発生しました!
+    }
+  }
+};
+xhr.send();
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('XMLHttpRequest', '#handler-xhr-onreadystatechange')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザーの互換性

+ +

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

diff --git a/files/ja/web/api/xmlhttprequest/readystate/index.html b/files/ja/web/api/xmlhttprequest/readystate/index.html deleted file mode 100644 index 3f8f8568e7..0000000000 --- a/files/ja/web/api/xmlhttprequest/readystate/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: XMLHttpRequest.readyState -slug: Web/API/XMLHttpRequest/readyState -tags: - - AJAX - - Property - - Reference - - XMLHttpRequest -translation_of: Web/API/XMLHttpRequest/readyState ---- -

{{APIRef('XMLHttpRequest')}}

- -

XMLHttpRequest.readyState プロパティは XMLHttpRequest クライアントの状態を返します。XHR クライアントは次の状態のいずれかをとります:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
値状態説明
0UNSENTクライアントは作成済み。open() はまだ呼ばれていない。
1OPENEDopen() が呼び出し済み。
2HEADERS_RECEIVEDsend() が呼び出し済みで、ヘッダーとステータスが利用可能。
3LOADINGダウンロード中。responseText には部分データが入っている。
4DONE操作が完了した。
- -
-
UNSENT
-
XMLHttpRequest クライアントは作成済みだが、まだ open() メソッドは呼ばれていない。
-
OPENED
-
open() メソッドは実行済み。この状態の間は、リクエストヘッダーを setRequestHeader() メソッドを使ってセットできて、send() メソッドを呼び出して取得を開始できる。
-
HEADERS_RECEIVED
-
send() は呼び出し済みでレスポンスヘッダーを受け取り済み。
-
LOADING
-
レスポンスボディを受け取っている。ResponseType が "text" か空文字の場合、responseText はロードするごとに部分テキストを持つ。
-
DONE
-
取得操作が完了している。つまりデータ転送が完全に成功したか失敗したかどちらでもありうる。
-
- -
-

状態名は Internet Explorer 11 以前のバージョンと異なります。UNSENT, OPENED, HEADERS_RECEIVED, LOADING,DONE, の代わりに、READYSTATE_UNINITIALIZED (0), READYSTATE_LOADING (1), READYSTATE_LOADED (2), READYSTATE_INTERACTIVE (3) and READYSTATE_COMPLETE (4) が使われています。

-
- -

例

- -
var xhr = new XMLHttpRequest();
-console.log('UNSENT', xhr.readyState); // readyState will be 0
-
-xhr.open('GET', '/api', true);
-console.log('OPENED', xhr.readyState); // readyState will be 1
-
-xhr.onprogress = function () {
-    console.log('LOADING', xhr.readyState); // readyState will be 3
-};
-
-xhr.onload = function () {
-    console.log('DONE', xhr.readyState); // readyState will be 4
-};
-
-xhr.send(null);
-
- -

仕様

- - - - - - - - - - - - - - -
仕様書策定状況コメント
{{SpecName('XMLHttpRequest', '#states')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
- -

ブラウザ実装状況

- - - -

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

diff --git a/files/ja/web/api/xmlhttprequest/readystate/index.md b/files/ja/web/api/xmlhttprequest/readystate/index.md new file mode 100644 index 0000000000..3f8f8568e7 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/readystate/index.md @@ -0,0 +1,107 @@ +--- +title: XMLHttpRequest.readyState +slug: Web/API/XMLHttpRequest/readyState +tags: + - AJAX + - Property + - Reference + - XMLHttpRequest +translation_of: Web/API/XMLHttpRequest/readyState +--- +

{{APIRef('XMLHttpRequest')}}

+ +

XMLHttpRequest.readyState プロパティは XMLHttpRequest クライアントの状態を返します。XHR クライアントは次の状態のいずれかをとります:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
値状態説明
0UNSENTクライアントは作成済み。open() はまだ呼ばれていない。
1OPENEDopen() が呼び出し済み。
2HEADERS_RECEIVEDsend() が呼び出し済みで、ヘッダーとステータスが利用可能。
3LOADINGダウンロード中。responseText には部分データが入っている。
4DONE操作が完了した。
+ +
+
UNSENT
+
XMLHttpRequest クライアントは作成済みだが、まだ open() メソッドは呼ばれていない。
+
OPENED
+
open() メソッドは実行済み。この状態の間は、リクエストヘッダーを setRequestHeader() メソッドを使ってセットできて、send() メソッドを呼び出して取得を開始できる。
+
HEADERS_RECEIVED
+
send() は呼び出し済みでレスポンスヘッダーを受け取り済み。
+
LOADING
+
レスポンスボディを受け取っている。ResponseType が "text" か空文字の場合、responseText はロードするごとに部分テキストを持つ。
+
DONE
+
取得操作が完了している。つまりデータ転送が完全に成功したか失敗したかどちらでもありうる。
+
+ +
+

状態名は Internet Explorer 11 以前のバージョンと異なります。UNSENT, OPENED, HEADERS_RECEIVED, LOADING,DONE, の代わりに、READYSTATE_UNINITIALIZED (0), READYSTATE_LOADING (1), READYSTATE_LOADED (2), READYSTATE_INTERACTIVE (3) and READYSTATE_COMPLETE (4) が使われています。

+
+ +

例

+ +
var xhr = new XMLHttpRequest();
+console.log('UNSENT', xhr.readyState); // readyState will be 0
+
+xhr.open('GET', '/api', true);
+console.log('OPENED', xhr.readyState); // readyState will be 1
+
+xhr.onprogress = function () {
+    console.log('LOADING', xhr.readyState); // readyState will be 3
+};
+
+xhr.onload = function () {
+    console.log('DONE', xhr.readyState); // readyState will be 4
+};
+
+xhr.send(null);
+
+ +

仕様

+ + + + + + + + + + + + + + +
仕様書策定状況コメント
{{SpecName('XMLHttpRequest', '#states')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

ブラウザ実装状況

+ + + +

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

diff --git a/files/ja/web/api/xmlhttprequest/response/index.html b/files/ja/web/api/xmlhttprequest/response/index.html deleted file mode 100644 index 76e5e90fa3..0000000000 --- a/files/ja/web/api/xmlhttprequest/response/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: XMLHttpRequest.response -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')}}
- -

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

- -

構文

- -
var body = XMLHttpRequest.response;
-
- -

値

- -

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

- -

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

- -

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

- -

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

- -
-
- -

例

- -

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

- -

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

- -
var url = 'somePage.html'; //A local page
-
-function load(url, callback) {
-  var xhr = new XMLHttpRequest();
-
-  xhr.onreadystatechange = function() {
-    if (xhr.readyState === 4) {
-      callback(xhr.response);
-    }
-  }
-
-  xhr.open('GET', url, true);
-  xhr.send('');
-}
-
-
- -

仕様書

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

ブラウザの対応

- - - -

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

- -

関連

- - diff --git a/files/ja/web/api/xmlhttprequest/response/index.md b/files/ja/web/api/xmlhttprequest/response/index.md new file mode 100644 index 0000000000..76e5e90fa3 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/response/index.md @@ -0,0 +1,93 @@ +--- +title: XMLHttpRequest.response +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')}}
+ +

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

+ +

構文

+ +
var body = XMLHttpRequest.response;
+
+ +

値

+ +

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

+ +

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

+ +

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

+ +

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

+ +
+
+ +

例

+ +

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

+ +

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

+ +
var url = 'somePage.html'; //A local page
+
+function load(url, callback) {
+  var xhr = new XMLHttpRequest();
+
+  xhr.onreadystatechange = function() {
+    if (xhr.readyState === 4) {
+      callback(xhr.response);
+    }
+  }
+
+  xhr.open('GET', url, true);
+  xhr.send('');
+}
+
+
+ +

仕様書

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

ブラウザの対応

+ + + +

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

+ +

関連

+ + diff --git a/files/ja/web/api/xmlhttprequest/responsetext/index.html b/files/ja/web/api/xmlhttprequest/responsetext/index.html deleted file mode 100644 index e19cca99f4..0000000000 --- a/files/ja/web/api/xmlhttprequest/responsetext/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: XMLHttpRequest.responseText -slug: Web/API/XMLHttpRequest/responseText -tags: - - API - - Fetching Text - - Loading Text - - Property - - Read-only - - Reference - - XMLHttpRequest - - responseText - - プロパティ -translation_of: Web/API/XMLHttpRequest/responseText ---- -
{{draft}}
- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の responseText プロパティは読み取り専用で、送信されたリクエストに続いてサーバーから受け取ったテキストを返します。

- -

構文

- -
var resultText = XMLHttpRequest.responseText;
- -

値

- -

{{domxref("DOMString")}} で、 XMLHttpRequest を使用して受信したテキストデータ、またはリクエストが失敗したときは null、またはリクエストがまだ {{domxref("XMLHttpRequest.send", "send()")}} の呼び出しによって送信されていない場合は ""。

- -

非同期リクエストを処理している間、 responseText の値は、データが完全に受信できておらず不完全であっても、常にサーバーから受信した現在のコンテンツを持ちます。

- -

{{domxref("XMLHttpRequest.readyState", "readyState")}} の値が {{domxref("XMLHttpRequest.DONE", "XMLHttpRequest.DONE")}} (4) になり、 {{domxref("XMLHttpRequest.status", "status")}} の値が 200 ("OK") になった場合、コンテンツ全体が受信されたことが分かります。

- -

例外

- -
-
InvalidStateError
-
{{domxref("XMLHttpRequest.responseType")}} が空文字列または "text" のどちらにも設定されていません。 responseText プロパティはテキストコンテンツのみで有効なので、他の値はエラーの状態です。
-
- -

例

- -
var xhr = new XMLHttpRequest();
-xhr.open('GET', '/server', true);
-
-// If specified, responseType must be empty string or "text"
-xhr.responseType = 'text';
-
-xhr.onload = function () {
-    if (xhr.readyState === xhr.DONE) {
-        if (xhr.status === 200) {
-            console.log(xhr.response);
-            console.log(xhr.responseText);
-        }
-    }
-};
-
-xhr.send(null);
- -

仕様書

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

ブラウザーの互換性

- -

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

diff --git a/files/ja/web/api/xmlhttprequest/responsetext/index.md b/files/ja/web/api/xmlhttprequest/responsetext/index.md new file mode 100644 index 0000000000..e19cca99f4 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/responsetext/index.md @@ -0,0 +1,81 @@ +--- +title: XMLHttpRequest.responseText +slug: Web/API/XMLHttpRequest/responseText +tags: + - API + - Fetching Text + - Loading Text + - Property + - Read-only + - Reference + - XMLHttpRequest + - responseText + - プロパティ +translation_of: Web/API/XMLHttpRequest/responseText +--- +
{{draft}}
+ +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の responseText プロパティは読み取り専用で、送信されたリクエストに続いてサーバーから受け取ったテキストを返します。

+ +

構文

+ +
var resultText = XMLHttpRequest.responseText;
+ +

値

+ +

{{domxref("DOMString")}} で、 XMLHttpRequest を使用して受信したテキストデータ、またはリクエストが失敗したときは null、またはリクエストがまだ {{domxref("XMLHttpRequest.send", "send()")}} の呼び出しによって送信されていない場合は ""。

+ +

非同期リクエストを処理している間、 responseText の値は、データが完全に受信できておらず不完全であっても、常にサーバーから受信した現在のコンテンツを持ちます。

+ +

{{domxref("XMLHttpRequest.readyState", "readyState")}} の値が {{domxref("XMLHttpRequest.DONE", "XMLHttpRequest.DONE")}} (4) になり、 {{domxref("XMLHttpRequest.status", "status")}} の値が 200 ("OK") になった場合、コンテンツ全体が受信されたことが分かります。

+ +

例外

+ +
+
InvalidStateError
+
{{domxref("XMLHttpRequest.responseType")}} が空文字列または "text" のどちらにも設定されていません。 responseText プロパティはテキストコンテンツのみで有効なので、他の値はエラーの状態です。
+
+ +

例

+ +
var xhr = new XMLHttpRequest();
+xhr.open('GET', '/server', true);
+
+// If specified, responseType must be empty string or "text"
+xhr.responseType = 'text';
+
+xhr.onload = function () {
+    if (xhr.readyState === xhr.DONE) {
+        if (xhr.status === 200) {
+            console.log(xhr.response);
+            console.log(xhr.responseText);
+        }
+    }
+};
+
+xhr.send(null);
+ +

仕様書

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

ブラウザーの互換性

+ +

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

diff --git a/files/ja/web/api/xmlhttprequest/responsetype/index.html b/files/ja/web/api/xmlhttprequest/responsetype/index.html deleted file mode 100644 index 5fc67e0f19..0000000000 --- a/files/ja/web/api/xmlhttprequest/responsetype/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: XMLHttpRequest.responseType -slug: Web/API/XMLHttpRequest/responseType -tags: - - AJAX - - API - - HTTP - - HTTP Response - - HTTP Response Type - - HTTP レスポンス - - Property - - Reference - - Response - - XHR - - XMLHttpRequest - - responseType - - プロパティ -translation_of: Web/API/XMLHttpRequest/responseType ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の responseType プロパティは、列挙型の文字列地で、レスポンスに含まれているデータの型を示します。作者がレスポンスの型を変更することもできます。 responseType の値として空文字列が設定された場合は、既定値である text が使用されます。

- -

構文

- -
var type = XMLHttpRequest.responseType;
-
-XMLHttpRequest.responseType = type;
- -

値

- -

文字列で、レスポンスに含まれているデータの型を指定する {{domxref("XMLHttpRequestResponseType")}} 列挙型の値を取ります。

- -
-

responseType を特定の値に設定する場合は、サーバーが実際にその形式と互換性のあるレスポンスを送信していることを確認してください。サーバーが responseType に設定された値と互換性のないデータを返した場合、 {{domxref("XMLHttpRequest.response", "response")}} の値は null になります。

-
- -

responseType が対応している値は以下の通りです。

- -

{{page("/ja/docs/Web/API/XMLHttpRequestResponseType", "Values")}}

- -

例外

- -
-
InvalidAccessError
-
responseType の値の変更が同期モードの XMLHttpRequest 上で試みられたものの、 {{domxref("Worker")}} の中ではなかった場合。詳細については、下記の{{anch("Synchronous XHR restrictions", "同期 XHR の制限")}}を参照して下さい。
-
- -

使用上の注意

- -

同期 XHR の制限

- -

responseType の値を同期 XMLHttpRequest で変更することは、リクエストが {{domxref("Worker")}} に属している場合を除いてできません。この制限は、ブラウザーのメインスレッドをブロックしてユーザーの使い勝手を妨害する巨大なトランザクションが、同期操作で使用されないことを保証する対策の一環として設けられています。

- -

XMLHttpRequest は既定では非同期です。同期モードは、 false の値をオプションの async 引数に渡して {{domxref("XMLHttpRequest.open", "open()")}} ろ呼び出した場合のみ設定されます。

- -

Worker での制限

- -

responseType の値を document に指定しようとすると、 {{domxref("Worker")}} の中では失敗します。

- -

仕様書

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

ブラウザーの互換性

- -

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

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/responsetype/index.md b/files/ja/web/api/xmlhttprequest/responsetype/index.md new file mode 100644 index 0000000000..5fc67e0f19 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/responsetype/index.md @@ -0,0 +1,90 @@ +--- +title: XMLHttpRequest.responseType +slug: Web/API/XMLHttpRequest/responseType +tags: + - AJAX + - API + - HTTP + - HTTP Response + - HTTP Response Type + - HTTP レスポンス + - Property + - Reference + - Response + - XHR + - XMLHttpRequest + - responseType + - プロパティ +translation_of: Web/API/XMLHttpRequest/responseType +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の responseType プロパティは、列挙型の文字列地で、レスポンスに含まれているデータの型を示します。作者がレスポンスの型を変更することもできます。 responseType の値として空文字列が設定された場合は、既定値である text が使用されます。

+ +

構文

+ +
var type = XMLHttpRequest.responseType;
+
+XMLHttpRequest.responseType = type;
+ +

値

+ +

文字列で、レスポンスに含まれているデータの型を指定する {{domxref("XMLHttpRequestResponseType")}} 列挙型の値を取ります。

+ +
+

responseType を特定の値に設定する場合は、サーバーが実際にその形式と互換性のあるレスポンスを送信していることを確認してください。サーバーが responseType に設定された値と互換性のないデータを返した場合、 {{domxref("XMLHttpRequest.response", "response")}} の値は null になります。

+
+ +

responseType が対応している値は以下の通りです。

+ +

{{page("/ja/docs/Web/API/XMLHttpRequestResponseType", "Values")}}

+ +

例外

+ +
+
InvalidAccessError
+
responseType の値の変更が同期モードの XMLHttpRequest 上で試みられたものの、 {{domxref("Worker")}} の中ではなかった場合。詳細については、下記の{{anch("Synchronous XHR restrictions", "同期 XHR の制限")}}を参照して下さい。
+
+ +

使用上の注意

+ +

同期 XHR の制限

+ +

responseType の値を同期 XMLHttpRequest で変更することは、リクエストが {{domxref("Worker")}} に属している場合を除いてできません。この制限は、ブラウザーのメインスレッドをブロックしてユーザーの使い勝手を妨害する巨大なトランザクションが、同期操作で使用されないことを保証する対策の一環として設けられています。

+ +

XMLHttpRequest は既定では非同期です。同期モードは、 false の値をオプションの async 引数に渡して {{domxref("XMLHttpRequest.open", "open()")}} ろ呼び出した場合のみ設定されます。

+ +

Worker での制限

+ +

responseType の値を document に指定しようとすると、 {{domxref("Worker")}} の中では失敗します。

+ +

仕様書

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

ブラウザーの互換性

+ +

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

+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/responseurl/index.html b/files/ja/web/api/xmlhttprequest/responseurl/index.html deleted file mode 100644 index b0f909b7e0..0000000000 --- a/files/ja/web/api/xmlhttprequest/responseurl/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: XMLHttpRequest.responseURL -slug: Web/API/XMLHttpRequest/responseURL -tags: - - AJAX - - Read-only - - Reference - - URL - - XMLHttpRequest - - responseURL - - プロパティ -translation_of: Web/API/XMLHttpRequest/responseURL ---- -
{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.responseURL プロパティは読み取り専用で、レスポンスのシリアライズされた URL を返します。 URL が null の場合は、空文字を返します。 URL に存在する URL フラグメントはすべて取り除かれます。 responseURL の値は、任意のリダイレクト後に得られる最後の URL になります。

- -

例

- -
var xhr = new XMLHttpRequest();
-xhr.open('GET', 'http://example.com/test', true);
-xhr.onload = function () {
-  console.log(xhr.responseURL); // http://example.com/test
-};
-xhr.send(null);
- -

仕様書

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

ブラウザーの対応

- -

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

diff --git a/files/ja/web/api/xmlhttprequest/responseurl/index.md b/files/ja/web/api/xmlhttprequest/responseurl/index.md new file mode 100644 index 0000000000..b0f909b7e0 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/responseurl/index.md @@ -0,0 +1,48 @@ +--- +title: XMLHttpRequest.responseURL +slug: Web/API/XMLHttpRequest/responseURL +tags: + - AJAX + - Read-only + - Reference + - URL + - XMLHttpRequest + - responseURL + - プロパティ +translation_of: Web/API/XMLHttpRequest/responseURL +--- +
{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.responseURL プロパティは読み取り専用で、レスポンスのシリアライズされた URL を返します。 URL が null の場合は、空文字を返します。 URL に存在する URL フラグメントはすべて取り除かれます。 responseURL の値は、任意のリダイレクト後に得られる最後の URL になります。

+ +

例

+ +
var xhr = new XMLHttpRequest();
+xhr.open('GET', 'http://example.com/test', true);
+xhr.onload = function () {
+  console.log(xhr.responseURL); // http://example.com/test
+};
+xhr.send(null);
+ +

仕様書

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

ブラウザーの対応

+ +

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

diff --git a/files/ja/web/api/xmlhttprequest/responsexml/index.html b/files/ja/web/api/xmlhttprequest/responsexml/index.html deleted file mode 100644 index 26aa6ea804..0000000000 --- a/files/ja/web/api/xmlhttprequest/responsexml/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: XMLHttpRequest.responseXML -slug: Web/API/XMLHttpRequest/responseXML -tags: - - AJAX - - API - - Fetching XML - - Loading XML - - Property - - Read-only - - Reading XML - - Reference - - Transfer - - XML - - XMLHttpRequest - - download - - responseXML - - upload - - アップロード - - ダウンロード - - プロパティ - - 変換 - - 読み取り専用 -translation_of: Web/API/XMLHttpRequest/responseXML ---- -
{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.responseXML は読み取り専用のプロパティで、リクエストによって受け取った HTML または XML を含む {{domxref("Document")}}、またはリクエストが成功しなかった場合、まだ送信されていない場合、データが XML または HTML として解釈できない場合は null を返します。

- -
-

メモ: responseXML という名前はこのプロパティの歴史の遺物です。これは HTML および XML の両方で動作します。

-
- -

ふつう、レスポンスは "text/xml" として解釈されます。 {{domxref("XMLHttpRequest.responseType", "responseType")}} が "document" に設定され、リクエストが非同期に行われた場合、レスポンスは代わりに "text/html" として解釈されます。他の型のデータでは、 data: の URL の場合と同様、 responseXML は null になります。

- -

サーバーが {{HTTPHeader("Content-Type")}} を "text/xml" とも "application/xml" とも指定しなかった場合、 {{domxref("XMLHttpRequest.overrideMimeType()")}} を使用して強制的に XML として解釈させることができます。

- -

このプロパティはワーカーでは使用できません。

- -

構文

- -
var data = XMLHttpRequest.responseXML;
-
- -

値

- -

{{domxref("XMLHttpRequest")}} を用いて受け取った XML または HTML を解釈した {{domxref("Document")}}、またはデータを受け取っていなかったり、データが XML/HTML でな買ったりした場合は null

- -

例外

- -
-
InvalidStateError
-
{{domxref("XMLHttpRequest.responseType", "responseType")}} が "document" でも空文字列でもない。
-
- -

例

- -
var xhr = new XMLHttpRequest;
-xhr.open('GET', '/server');
-
-// responseType を指定する場合は、空文字列または "document" でなければならない
-xhr.responseType = 'document';
-
-// レスポンスを XML として解釈するよう強制する
-xhr.overrideMimeType('text/xml');
-
-xhr.onload = function () {
-  if (xhr.readyState === xhr.DONE && xhr.status === 200) {
-    console.log(xhr.response, xhr.responseXML);
-  }
-};
-
-xhr.send();
- -

仕様書

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

ブラウザーの対応

- -

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

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/responsexml/index.md b/files/ja/web/api/xmlhttprequest/responsexml/index.md new file mode 100644 index 0000000000..26aa6ea804 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/responsexml/index.md @@ -0,0 +1,107 @@ +--- +title: XMLHttpRequest.responseXML +slug: Web/API/XMLHttpRequest/responseXML +tags: + - AJAX + - API + - Fetching XML + - Loading XML + - Property + - Read-only + - Reading XML + - Reference + - Transfer + - XML + - XMLHttpRequest + - download + - responseXML + - upload + - アップロード + - ダウンロード + - プロパティ + - 変換 + - 読み取り専用 +translation_of: Web/API/XMLHttpRequest/responseXML +--- +
{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.responseXML は読み取り専用のプロパティで、リクエストによって受け取った HTML または XML を含む {{domxref("Document")}}、またはリクエストが成功しなかった場合、まだ送信されていない場合、データが XML または HTML として解釈できない場合は null を返します。

+ +
+

メモ: responseXML という名前はこのプロパティの歴史の遺物です。これは HTML および XML の両方で動作します。

+
+ +

ふつう、レスポンスは "text/xml" として解釈されます。 {{domxref("XMLHttpRequest.responseType", "responseType")}} が "document" に設定され、リクエストが非同期に行われた場合、レスポンスは代わりに "text/html" として解釈されます。他の型のデータでは、 data: の URL の場合と同様、 responseXML は null になります。

+ +

サーバーが {{HTTPHeader("Content-Type")}} を "text/xml" とも "application/xml" とも指定しなかった場合、 {{domxref("XMLHttpRequest.overrideMimeType()")}} を使用して強制的に XML として解釈させることができます。

+ +

このプロパティはワーカーでは使用できません。

+ +

構文

+ +
var data = XMLHttpRequest.responseXML;
+
+ +

値

+ +

{{domxref("XMLHttpRequest")}} を用いて受け取った XML または HTML を解釈した {{domxref("Document")}}、またはデータを受け取っていなかったり、データが XML/HTML でな買ったりした場合は null

+ +

例外

+ +
+
InvalidStateError
+
{{domxref("XMLHttpRequest.responseType", "responseType")}} が "document" でも空文字列でもない。
+
+ +

例

+ +
var xhr = new XMLHttpRequest;
+xhr.open('GET', '/server');
+
+// responseType を指定する場合は、空文字列または "document" でなければならない
+xhr.responseType = 'document';
+
+// レスポンスを XML として解釈するよう強制する
+xhr.overrideMimeType('text/xml');
+
+xhr.onload = function () {
+  if (xhr.readyState === xhr.DONE && xhr.status === 200) {
+    console.log(xhr.response, xhr.responseXML);
+  }
+};
+
+xhr.send();
+ +

仕様書

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

ブラウザーの対応

+ +

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

+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/status/index.html b/files/ja/web/api/xmlhttprequest/status/index.html deleted file mode 100644 index 6b42a3ceb2..0000000000 --- a/files/ja/web/api/xmlhttprequest/status/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: XMLHttpRequest.status -slug: Web/API/XMLHttpRequest/status -tags: - - API - - XMLHttpRequest - - XMLHttpRequest の結果 - - status - - エラー - - プロパティ - - リファレンス -translation_of: Web/API/XMLHttpRequest/status ---- -
{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.status プロパティは読み取り専用で、 XMLHttpRequest のレスポンスにおける数値の HTTP ステータスコードを返します。

- - - -

リクエストが完了する前は、 status の値は 0 になります。 XMLHttpRequest がエラーになった場合も、ブラウザーはステータスとして 0 を返します。

- -

例

- -
var xhr = new XMLHttpRequest();
-console.log('UNSENT: ', xhr.status);
-
-xhr.open('GET', '/server');
-console.log('OPENED: ', xhr.status);
-
-xhr.onprogress = function () {
-  console.log('LOADING: ', xhr.status);
-};
-
-xhr.onload = function () {
-  console.log('DONE: ', xhr.status);
-};
-
-xhr.send();
-
-/**
- * Outputs the following:
- *
- * UNSENT: 0
- * OPENED: 0
- * LOADING: 200
- * DONE: 200
- */
-
- -

仕様書

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

ブラウザーの互換性

- -

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

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/status/index.md b/files/ja/web/api/xmlhttprequest/status/index.md new file mode 100644 index 0000000000..6b42a3ceb2 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/status/index.md @@ -0,0 +1,78 @@ +--- +title: XMLHttpRequest.status +slug: Web/API/XMLHttpRequest/status +tags: + - API + - XMLHttpRequest + - XMLHttpRequest の結果 + - status + - エラー + - プロパティ + - リファレンス +translation_of: Web/API/XMLHttpRequest/status +--- +
{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.status プロパティは読み取り専用で、 XMLHttpRequest のレスポンスにおける数値の HTTP ステータスコードを返します。

+ + + +

リクエストが完了する前は、 status の値は 0 になります。 XMLHttpRequest がエラーになった場合も、ブラウザーはステータスとして 0 を返します。

+ +

例

+ +
var xhr = new XMLHttpRequest();
+console.log('UNSENT: ', xhr.status);
+
+xhr.open('GET', '/server');
+console.log('OPENED: ', xhr.status);
+
+xhr.onprogress = function () {
+  console.log('LOADING: ', xhr.status);
+};
+
+xhr.onload = function () {
+  console.log('DONE: ', xhr.status);
+};
+
+xhr.send();
+
+/**
+ * Outputs the following:
+ *
+ * UNSENT: 0
+ * OPENED: 0
+ * LOADING: 200
+ * DONE: 200
+ */
+
+ +

仕様書

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

ブラウザーの互換性

+ +

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

+ +

関連情報

+ + diff --git a/files/ja/web/api/xmlhttprequest/timeout/index.html b/files/ja/web/api/xmlhttprequest/timeout/index.html deleted file mode 100644 index 5016ca6fe0..0000000000 --- a/files/ja/web/api/xmlhttprequest/timeout/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: XMLHttpRequest.timeout -slug: Web/API/XMLHttpRequest/timeout -tags: - - AJAX - - Reference - - XHR - - XMLHttpRequest - - timeout - - プロパティ - - 非同期 XHR - - 非同期 XMLHttpRequest -translation_of: Web/API/XMLHttpRequest/timeout ---- -
{{APIRef('XMLHttpRequest')}}
- -

XMLHttpRequest.timeout はリクエストが自動的に終了するまでの時間をミリ秒で示す unsigned long 型のプロパティです。既定値はタイムアウトが無いことを示す 0 に設定されています。 timeout は{{Glossary('document environment', '文書環境')}}で利用される同期型や InvalidAccessError の例外を投げる XMLHttpRequests に利用することはできません。タイムアウトとなった場合、 timeout イベントが発火します。 {{gecko_minversion_inline("12.0")}}

- -
-
-
メモ: timeout は自分のウィンドウを持つ場合に同期で利用することは認められていません。
-
-
非同期リクエストでの timeout の使用
-
- -

Internet Explorer においては、 timeout プロパティは open() メソッドを呼んでから send() メソッドを呼ぶまでの間しかセットすることはできません。

- -

例

- -
var xhr = new XMLHttpRequest();
-xhr.open('GET', '/server', true);
-
-xhr.timeout = 2000; // time in milliseconds
-
-xhr.onload = function () {
-  // Request finished. Do processing here.
-};
-
-xhr.ontimeout = function (e) {
-  // XMLHttpRequest timed out. Do something here.
-};
-
-xhr.send(null);
- -

仕様書

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

ブラウザーの対応

- -

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

diff --git a/files/ja/web/api/xmlhttprequest/timeout/index.md b/files/ja/web/api/xmlhttprequest/timeout/index.md new file mode 100644 index 0000000000..5016ca6fe0 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/timeout/index.md @@ -0,0 +1,66 @@ +--- +title: XMLHttpRequest.timeout +slug: Web/API/XMLHttpRequest/timeout +tags: + - AJAX + - Reference + - XHR + - XMLHttpRequest + - timeout + - プロパティ + - 非同期 XHR + - 非同期 XMLHttpRequest +translation_of: Web/API/XMLHttpRequest/timeout +--- +
{{APIRef('XMLHttpRequest')}}
+ +

XMLHttpRequest.timeout はリクエストが自動的に終了するまでの時間をミリ秒で示す unsigned long 型のプロパティです。既定値はタイムアウトが無いことを示す 0 に設定されています。 timeout は{{Glossary('document environment', '文書環境')}}で利用される同期型や InvalidAccessError の例外を投げる XMLHttpRequests に利用することはできません。タイムアウトとなった場合、 timeout イベントが発火します。 {{gecko_minversion_inline("12.0")}}

+ +
+
+
メモ: timeout は自分のウィンドウを持つ場合に同期で利用することは認められていません。
+
+
非同期リクエストでの timeout の使用
+
+ +

Internet Explorer においては、 timeout プロパティは open() メソッドを呼んでから send() メソッドを呼ぶまでの間しかセットすることはできません。

+ +

例

+ +
var xhr = new XMLHttpRequest();
+xhr.open('GET', '/server', true);
+
+xhr.timeout = 2000; // time in milliseconds
+
+xhr.onload = function () {
+  // Request finished. Do processing here.
+};
+
+xhr.ontimeout = function (e) {
+  // XMLHttpRequest timed out. Do something here.
+};
+
+xhr.send(null);
+ +

仕様書

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

ブラウザーの対応

+ +

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

diff --git a/files/ja/web/api/xmlhttprequest/upload/index.html b/files/ja/web/api/xmlhttprequest/upload/index.html deleted file mode 100644 index a570608060..0000000000 --- a/files/ja/web/api/xmlhttprequest/upload/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: XMLHttpRequest.upload -slug: Web/API/XMLHttpRequest/upload -tags: - - AJAX - - API - - Monitoring XMLHttpRequest - - Property - - Read-only - - Reference - - Sending Files - - Uploading - - XHR - - XHR Uploads - - XMLHttpRequest - - XMLHttpRequest Uploads - - XMLHttpRequestUpload - - upload - - アップロード - - ファイル送信 -translation_of: Web/API/XMLHttpRequest/upload ---- -
{{APIRef('XMLHttpRequest')}}
- -

{{domxref("XMLHttpRequest")}} の upload プロパティは、アップロードの進捗を監視することができる {{domxref("XMLHttpRequestUpload")}} オブジェクトを返します。これは不透過なオブジェクトですが、 {{domxref("XMLHttpRequestEventTarget")}} でもあるため、進捗を追跡するために添付することができます。

- -

以下のイベントは upload オブジェクトを起動してアップロードを監視する目に使用することができます。

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
イベントイベントリスナー解説
{{event("loadstart")}}{{domxref("XMLHttpRequest.onloadstart", "onloadstart")}}アップロードが始まった。
{{event("progress")}}{{domxref("XMLHttpRequest.onprogress", "onprogress")}}進捗の量を示すために定期的に発生する。
{{event("abort")}}{{domxref("XMLHttpRequest.onabort", "onabort")}}アップロード操作が中断された。
{{event("error")}}{{domxref("XMLHttpRequest.onerror", "onerror")}}アップロードがエラーのために失敗した。
{{event("load")}}{{domxref("XMLHttpRequest.onload", "onload")}}アップロードが完全に成功した。
{{event("timeout")}}{{domxref("XMLHttpRequest.ontimeout", "ontimeout")}}返事が {{domxref("XMLHttpRequest.timeout")}} で指定された時間間隔内に届かなかったため、アップロードがタイムアウトされた。
{{event("loadend")}}{{domxref("XMLHttpRequest.onloadend", "onloadend")}}アップロードが終了した。このイベントでは成功か失敗かを区別することはできず、結果にかかわらずアップロードが終了したときに送信されます。このイベントの前に、 load, error, abort, timeout のうちの1つがアップロードが終了した理由を示すために配信されます。
- -

仕様書

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

ブラウザーの互換性

- -

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

- -

関連情報

- - diff --git a/files/ja/web/api/xmlhttprequest/upload/index.md b/files/ja/web/api/xmlhttprequest/upload/index.md new file mode 100644 index 0000000000..a570608060 --- /dev/null +++ b/files/ja/web/api/xmlhttprequest/upload/index.md @@ -0,0 +1,103 @@ +--- +title: XMLHttpRequest.upload +slug: Web/API/XMLHttpRequest/upload +tags: + - AJAX + - API + - Monitoring XMLHttpRequest + - Property + - Read-only + - Reference + - Sending Files + - Uploading + - XHR + - XHR Uploads + - XMLHttpRequest + - XMLHttpRequest Uploads + - XMLHttpRequestUpload + - upload + - アップロード + - ファイル送信 +translation_of: Web/API/XMLHttpRequest/upload +--- +
{{APIRef('XMLHttpRequest')}}
+ +

{{domxref("XMLHttpRequest")}} の upload プロパティは、アップロードの進捗を監視することができる {{domxref("XMLHttpRequestUpload")}} オブジェクトを返します。これは不透過なオブジェクトですが、 {{domxref("XMLHttpRequestEventTarget")}} でもあるため、進捗を追跡するために添付することができます。

+ +

以下のイベントは upload オブジェクトを起動してアップロードを監視する目に使用することができます。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
イベントイベントリスナー解説
{{event("loadstart")}}{{domxref("XMLHttpRequest.onloadstart", "onloadstart")}}アップロードが始まった。
{{event("progress")}}{{domxref("XMLHttpRequest.onprogress", "onprogress")}}進捗の量を示すために定期的に発生する。
{{event("abort")}}{{domxref("XMLHttpRequest.onabort", "onabort")}}アップロード操作が中断された。
{{event("error")}}{{domxref("XMLHttpRequest.onerror", "onerror")}}アップロードがエラーのために失敗した。
{{event("load")}}{{domxref("XMLHttpRequest.onload", "onload")}}アップロードが完全に成功した。
{{event("timeout")}}{{domxref("XMLHttpRequest.ontimeout", "ontimeout")}}返事が {{domxref("XMLHttpRequest.timeout")}} で指定された時間間隔内に届かなかったため、アップロードがタイムアウトされた。
{{event("loadend")}}{{domxref("XMLHttpRequest.onloadend", "onloadend")}}アップロードが終了した。このイベントでは成功か失敗かを区別することはできず、結果にかかわらずアップロードが終了したときに送信されます。このイベントの前に、 load, error, abort, timeout のうちの1つがアップロードが終了した理由を示すために配信されます。
+ +

仕様書

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

ブラウザーの互換性

+ +

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

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf