XMLHttpRequest.readyState

XMLHttpRequest.readyState 属性返回一个 XMLHttpRequest 代理当前所处的状态。一个 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

请求操作已经完成。这意味着数据传输已经彻底完成或失败。

备注: 在 IE 中,状态有着不同的名称,并不是 UNSENTOPENEDHEADERS_RECEIVEDLOADINGDONE,而是 READYSTATE_UNINITIALIZED (0),READYSTATE_LOADING (1) ,READYSTATE_LOADED (2) ,READYSTATE_INTERACTIVE (3) 和 READYSTATE_COMPLETE (4) 。

示例

js
var xhr = new XMLHttpRequest();
console.log("UNSENT", xhr.readyState); // readyState 为 0

xhr.open("GET", "/api", true);
console.log("OPENED", xhr.readyState); // readyState 为 1

xhr.onprogress = function () {
  console.log("LOADING", xhr.readyState); // readyState 为 3
};

xhr.onload = function () {
  console.log("DONE", xhr.readyState); // readyState 为 4
};

xhr.send(null);

规范

Specification
XMLHttpRequest Standard
# states

浏览器兼容性

BCD tables only load in the browser