XMLHttpRequest: statusText プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

メモ: この機能はウェブワーカー内で利用可能ですが、サービスワーカーでは使用できません。

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

サーバーが明示的にステータスのテキストを指定しなかった場合、 statusText は既定値 "OK" と見なされます。

メモ: HTTP/2 コネクションのレスポンスでは、常に空文字列になります。これは HTTP/2 がステータステキストに対応していないからです。

値

文字列です。

例

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
 */