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