XMLHttpRequest: statusText-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die schreibgeschützte XMLHttpRequest.statusText-Eigenschaft gibt einen String zurück, der die Statusnachricht der Antwort enthält, wie sie vom HTTP-Server zurückgegeben wurde. Im Gegensatz zu XMLHttpRequest.status, das einen numerischen Statuscode angibt, enthält diese Eigenschaft den Text des Antwortstatus, wie "OK" oder "Not Found". Wenn sich der readyState der Anfrage im UNSENT- oder OPENED-Zustand befindet, wird der Wert von statusText ein leerer String sein.
Falls die Serverantwort keinen Status-Text explizit angibt, nimmt statusText den Standardwert "OK" an.
Hinweis: Antworten über eine HTTP/2-Verbindung haben immer einen leeren String als Statusnachricht, da HTTP/2 diese nicht unterstützt.
Wert
Ein String.
Beispiele
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);
/**
* Outputs the following:
*
* 0 UNSENT
* 1 OPENED
* 3 LOADING OK
* 4 DONE OK
*/
Spezifikationen
| Spezifikation |
|---|
| XMLHttpRequest # the-statustext-attribute |
Browser-Kompatibilität
Siehe auch
- Liste der HTTP-Status
- HTTP
- WHATWG Fetch Living Standard