XMLHttpRequest: statusText プロパティ

XMLHttpRequest.statusText は読み取り専用のプロパティで、文字列で HTTP サーバーから返されるステータスメッセージを示します。 XMLHTTPRequest.status が数値のステータスコードを示すのとは異なり、このプロパティはレスポンスステータスのテキストを、 "OK" や "Not Found" のように示します。リクエストの readyState が UNSENT または OPENED の状態であった場合、 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);

/**
 * 以下のように出力されます。
 *
 * 0 UNSENT
 * 1 OPENED
 * 3 LOADING OK
 * 4 DONE OK
 */

仕様書

Specification
XMLHttpRequest Standard
# the-statustext-attribute

ブラウザーの互換性

BCD tables only load in the browser

関連情報