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

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