XMLHttpRequest: statusText 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

注意:此功能在 Web Workers 中可用,但 Service Workers 除外。

只读的 XMLHttpRequest.statusText 属性返回一个字符串,其中包含 HTTP 服务器返回的响应状态消息。与表示数值状态码的 XMLHttpRequest.status 不同,此属性包含响应状态的文本,例如“OK”或“Not Found”。如果请求的 readyState 处于 UNSENTOPENED 状态,则 statusText 的值将是一个空字符串。

如果服务器响应没有显式指定状态文本,statusText 将假定默认值“OK”。

注意: 通过 HTTP/2 连接进行的响应的状态消息将始终为空字符串,因为 HTTP/2 不支持它们。

字符串。

示例

js
const xhr = new XMLHttpRequest();
console.log("0 UNSENT", xhr.statusText);

xhr.open("GET", "/server", true);
console.log("1 OPENED", xhr.statusText);

xhr.onprogress = () => {
  console.log("3 LOADING", xhr.statusText);
};

xhr.onload = () => {
  console.log("4 DONE", xhr.statusText);
};

xhr.send(null);

/**
 * Outputs the following:
 *
 * 0 UNSENT
 * 1 OPENED
 * 3 LOADING OK
 * 4 DONE OK
 */

规范

规范
XMLHttpRequest
# the-statustext-attribute

浏览器兼容性

另见