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.

In diesem Artikel

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

XMLHttpRequest API
XMLHttpRequest
Konstruktor
1. XMLHttpRequest()
Instanzeigenschaften
Instanzmethoden
Events
1. readystatechange
Vererbung
1. XMLHttpRequestEventTarget
2. EventTarget
Verwandte Seiten für XMLHttpRequest API
Anleitungen
1. Verwendung von XMLHttpRequest
2. HTML in XMLHttpRequest
3. Synchrone und asynchrone Anfragen
4. Senden und Empfangen von Binärdaten
5. Verwenden von FormData-Objekten

XMLHttpRequest: statusText-Eigenschaft

In diesem Artikel

Wert

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN