XMLHttpRequest.readyState

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() メソッドを使ってセットでき、send() メソッドを呼び出すと取得を開始できる。
HEADERS_RECEIVED: send() は呼び出し済みで、レスポンスヘッダーを受け取り済み。
LOADING: レスポンス本文を受信中。 responseType が "text" または空文字列の場合、 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) が使われています。

例

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);

仕様書

Specification
XMLHttpRequest Standard # states

ブラウザーの互換性

BCD tables only load in the browser