From f3c4aac32df29ae5735bc33873eda74a3eec7443 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sat, 29 Jan 2022 22:26:02 +0900 Subject: 2021/09/15 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ja/web/api/xmlhttprequest/readystate/index.md | 118 +++++++-------------- 1 file changed, 37 insertions(+), 81 deletions(-) (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/xmlhttprequest/readystate/index.md b/files/ja/web/api/xmlhttprequest/readystate/index.md index 3f8f8568e7..0cfc581697 100644 --- a/files/ja/web/api/xmlhttprequest/readystate/index.md +++ b/files/ja/web/api/xmlhttprequest/readystate/index.md @@ -3,70 +3,41 @@ title: XMLHttpRequest.readyState slug: Web/API/XMLHttpRequest/readyState tags: - AJAX - - Property - - Reference + - プロパティ + - リファレンス - XMLHttpRequest +browser-compat: api.XMLHttpRequest.readyState 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();
+{{APIRef('XMLHttpRequest')}}
+
+**XMLHttpRequest.readyState** プロパティは XMLHttpRequest (XHR) クライアントの状態を返します。XHR クライアントは次の状態のいずれかをとります。
+
+| 値    | 状態               | 説明                                                            |
+| ----- | ------------------ | --------------------------------------------------------------- |
+| `0`   | `UNSENT`           | クライアントは作成済み。 `open()` はまだ呼ばれていない。        |
+| `1`   | `OPENED`           | `open()` が呼び出し済み。                                       |
+| `2`   | `HEADERS_RECEIVED` | `send()` が呼び出し済みで、ヘッダーとステータスが利用可能。     |
+| `3`   | `LOADING`          | ダウンロード中。`responseText` には部分データが入っている。     |
+| `4`   | `DONE`             | 操作が完了した。                                                |
+
+- UNSENT
+  - : XMLHttpRequest クライアントは作成済みだが、まだ open() メソッドは呼ばれていない。
+- OPENED
+  - : open() メソッドは実行済み。この状態の間は、リクエストヘッダーを [setRequestHeader()](/ja/docs/Web/API/XMLHttpRequest/setRequestHeader) メソッドを使ってセットでき、[send()](/ja/docs/Web/API/XMLHttpRequest/send) メソッドを呼び出すと取得を開始できる。
+- HEADERS_RECEIVED
+  - : send() は呼び出し済みで、レスポンスヘッダーを受け取り済み。
+- LOADING
+  - : レスポンス本文を受信中。 [`responseType`](/ja/docs/Web/API/XMLHttpRequest/responseType) が "text" または空文字列の場合、 [`responseText`](/ja/docs/Web/API/XMLHttpRequest/responseText) は読み込み中の部分的なテキストになる。
+- DONE
+  - : 取得操作が完了している。これはデータ転送が成功または失敗で完了したことを意味している。
+
+> **Note:** 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) が使われています。
+
+## 例
+
+```js
+var xhr = new XMLHttpRequest();
 console.log('UNSENT', xhr.readyState); // readyState will be 0
 
 xhr.open('GET', '/api', true);
@@ -81,27 +52,12 @@ xhr.onload = function () {
 };
 
 xhr.send(null);
-
- -

仕様

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

ブラウザ実装状況

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

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

+{{Compat}} -- cgit v1.2.3-54-g00ecf