diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-01-29 22:26:02 +0900 |
---|---|---|
committer | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-05 13:19:25 +0900 |
commit | f3c4aac32df29ae5735bc33873eda74a3eec7443 (patch) | |
tree | 7708f4ccd74c90b2a44b7ad5eb3e5ec95f149f56 /files/ja/web/api | |
parent | a1ee3f2a799e2e2c9fe9bb9247e3c6067bbf0b26 (diff) | |
download | translated-content-f3c4aac32df29ae5735bc33873eda74a3eec7443.tar.gz translated-content-f3c4aac32df29ae5735bc33873eda74a3eec7443.tar.bz2 translated-content-f3c4aac32df29ae5735bc33873eda74a3eec7443.zip |
2021/09/15 時点の英語版に同期
Diffstat (limited to 'files/ja/web/api')
-rw-r--r-- | files/ja/web/api/xmlhttprequest/readystate/index.md | 118 |
1 files changed, 37 insertions, 81 deletions
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 --- -<p>{{APIRef('XMLHttpRequest')}}</p> - -<p><strong>XMLHttpRequest.readyState</strong> プロパティは XMLHttpRequest クライアントの状態を返します。<abbr title="XMLHttpRequest">XHR</abbr> クライアントは次の状態のいずれかをとります:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">値</td> - <td class="header">状態</td> - <td class="header">説明</td> - </tr> - <tr> - <td><code>0</code></td> - <td><code>UNSENT</code></td> - <td>クライアントは作成済み。<code>open()</code> はまだ呼ばれていない。</td> - </tr> - <tr> - <td><code>1</code></td> - <td><code>OPENED</code></td> - <td><code>open()</code> が呼び出し済み。</td> - </tr> - <tr> - <td><code>2</code></td> - <td><code>HEADERS_RECEIVED</code></td> - <td><code>send()</code> が呼び出し済みで、ヘッダーとステータスが利用可能。</td> - </tr> - <tr> - <td><code>3</code></td> - <td><code>LOADING</code></td> - <td>ダウンロード中。<code>responseText</code> には部分データが入っている。</td> - </tr> - <tr> - <td><code>4</code></td> - <td><code>DONE</code></td> - <td>操作が完了した。</td> - </tr> - </tbody> -</table> - -<dl> - <dt>UNSENT</dt> - <dd>XMLHttpRequest クライアントは作成済みだが、まだ open() メソッドは呼ばれていない。</dd> - <dt>OPENED</dt> - <dd>open() メソッドは実行済み。この状態の間は、リクエストヘッダーを <a href="/ja/docs/Web/API/XMLHttpRequest/setRequestHeader">setRequestHeader()</a> メソッドを使ってセットできて、<a href="/ja/docs/Web/API/XMLHttpRequest/send">send()</a> メソッドを呼び出して取得を開始できる。</dd> - <dt>HEADERS_RECEIVED</dt> - <dd>send() は呼び出し済みでレスポンスヘッダーを受け取り済み。</dd> - <dt>LOADING</dt> - <dd>レスポンスボディを受け取っている。<code><a href="/ja/docs/Web/API/XMLHttpRequest/responseType">ResponseType</a></code> が "text" か空文字の場合、<code><a href="/ja/docs/Web/API/XMLHttpRequest/responseText">responseText</a></code> はロードするごとに部分テキストを持つ。</dd> - <dt>DONE</dt> - <dd>取得操作が完了している。つまりデータ転送が完全に成功したか失敗したかどちらでもありうる。</dd> -</dl> - -<div class="note"> -<p>状態名は Internet Explorer 11 以前のバージョンと異なります。<code>UNSENT</code>, <code>OPENED</code>,<code> HEADERS_RECEIVED</code>,<code> LOADING</code>,<code>DONE</code>, の代わりに、<code>READYSTATE_UNINITIALIZED</code> (0), <code>READYSTATE_LOADING</code> (1), <code>READYSTATE_LOADED</code> (2), <code>READYSTATE_INTERACTIVE</code> (3) and <code>READYSTATE_COMPLETE</code> (4) が使われています。</p> -</div> - -<h2 id="Example" name="Example">例</h2> - -<pre class="brush: js">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); -</pre> - -<h2 id="Specifications" name="Specifications">仕様</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">仕様書</th> - <th scope="col">策定状況</th> - <th scope="col">コメント</th> - </tr> - <tr> - <td>{{SpecName('XMLHttpRequest', '#states')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>WHATWG living standard</td> - </tr> - </tbody> -</table> +``` -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2> +## 仕様書 +{{Specifications}} +## ブラウザーの互換性 -<p>{{Compat("api.XMLHttpRequest.readyState")}}</p> +{{Compat}} |