XMLHttpRequest.readyState

XMLHttpRequest.readyState 屬性會回傳一個 XMLHttpRequest 客戶端物件目前的狀態。一個 XHR 客戶端可以為下列其中一種狀態：

值	狀態	說明
`0`	`UNSENT`	客戶端已被建立，但 `open()` 方法尚未被呼叫。
`1`	`OPENED`	`open()` 方法已被呼叫。
`2`	`HEADERS_RECEIVED`	`send()` 方法已被呼叫，而且可取得 header 與狀態。
`3`	`LOADING`	回應資料下載中，此時 `responseText` 會擁有部分資料。
`4`	`DONE`	完成下載操作。

UNSENT: XMLHttpRequest 客戶端物件已被建立，但 open() 方法尚未被呼叫。
OPENED: open() 方法已被呼叫。於此狀態時，可以使用 setRequestHeader() 方法設定請求標頭（request headers），並可呼叫 send() (en-US) 方法來發送請求。
HEADERS_RECEIVED: send() 方法已被呼叫，並且已接收到回應標頭（response header）。
LOADING: 正在接收回應內容（response's body）。如 responseType (en-US) 屬性為 "text" 或空字串，則 responseText (en-US) 屬性將會在載入的過程中擁有已載入部分之回應（response）內容中的文字。
DONE: 請求操作已完成。這意味著資料傳輸可能已成功完成或是已失敗。

這些狀態名稱在 Internet Explorer 中略有不同。其中 UNSENT, OPENED, HEADERS_RECEIVED, LOADING 和 DONE 變成了 READYSTATE_UNINITIALIZED (0), READYSTATE_LOADING (1), READYSTATE_LOADED (2), READYSTATE_INTERACTIVE (3) 和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);

規範

規範	狀態	註解
XMLHttpRequest	Living Standard	WHATWG living standard

瀏覽器相容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Desktop
Mobile

功能	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
基本支援	1	1.0 (1.7 or earlier)^[1]	7	(Yes)	1.2

功能	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
基本支援	?	1.0	(Yes)	?	?	?