XMLHttpRequest.readyState
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
-
请求操作已经完成。这意味着数据传输已经彻底完成或失败。
示例
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