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 July 2015.
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