XMLHttpRequest: statusText-Eigenschaft

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.

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 Statusmeldung der Antwort enthält, wie sie vom HTTP-Server zurückgegeben wird. Im Gegensatz zu XMLHTTPRequest.status, das einen numerischen Statuscode angibt, enthält diese Eigenschaft den Text des Antwortstatus, wie "OK" oder "Not Found". Wenn der readyState der Anfrage im Zustand UNSENT oder OPENED ist, wird der Wert von statusText ein leerer String sein.

Wenn die Serverantwort keinen Status-Text explizit angibt, nimmt statusText den Standardwert "OK" an.

Hinweis: Antworten über eine HTTP/2-Verbindung haben immer eine leere Zeichenkette als Statusmeldung, da HTTP/2 diese nicht unterstützt.

Wert

Ein String.

Beispiele

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);

/**
 * Outputs the following:
 *
 * 0 UNSENT
 * 1 OPENED
 * 3 LOADING OK
 * 4 DONE OK
 */

Spezifikationen

Specification
XMLHttpRequest
# the-statustext-attribute

Browser-Kompatibilität

Siehe auch