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 eine Zeichenkette zurück, die 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". Befindet sich der readyState der Anfrage im UNSENT- oder OPENED-Zustand, wird der Wert von statusText eine leere Zeichenkette sein.

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

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

Wert

Eine Zeichenkette.

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 Standard
# the-statustext-attribute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch