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