XMLHttpRequest: readyState-Eigenschaft - Web-APIs | MDN

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.

Die XMLHttpRequest.readyState-Eigenschaft gibt den Zustand an, in dem sich ein XMLHttpRequest-Client befindet. Ein XHR-Client existiert in einem der folgenden Zustände:

Wert Zustand Beschreibung
0 UNSENT Der Client wurde erstellt. open() wurde noch nicht aufgerufen.
1 OPENED open() wurde aufgerufen.
2 HEADERS_RECEIVED send() wurde aufgerufen, und Header und Status sind verfügbar.
3 LOADING Wird heruntergeladen; responseText enthält teilweise Daten.
4 DONE Der Vorgang ist abgeschlossen.
UNSENT

Der XMLHttpRequest-Client wurde erstellt, aber die open()-Methode wurde noch nicht aufgerufen.

OPENED

Die open()-Methode wurde aufgerufen. Während dieses Zustands können die Anfrage-Header mit der [setRequestHeader()]-Methode(/de/docs/Web/API/XMLHttpRequest/setRequestHeader) gesetzt werden und die [send()]-Methode(/de/docs/Web/API/XMLHttpRequest/send) kann aufgerufen werden, die den Abruf initiieren wird.

HEADERS_RECEIVED

send() wurde aufgerufen, alle Weiterleitungen (falls vorhanden) wurden verfolgt und die Antwort-Header wurden empfangen.

LOADING

Der Körper der Antwort wird empfangen. Wenn responseType "text" oder leer ist, enthält responseText den teilweise geladenen Text der Antwort.

DONE

Der Abrufvorgang ist abgeschlossen. Das kann bedeuten, dass der Datentransfer entweder erfolgreich abgeschlossen oder fehlgeschlagen ist.

Beispiel

js

const xhr = new XMLHttpRequest();
console.log("UNSENT", xhr.readyState); // readyState will be 0

xhr.open("GET", "/api", true);
console.log("OPENED", xhr.readyState); // readyState will be 1

xhr.onprogress = () => {
  console.log("LOADING", xhr.readyState); // readyState will be 3
};

xhr.onload = () => {
  console.log("DONE", xhr.readyState); // readyState will be 4
};

xhr.send(null);

Spezifikationen

Spezifikation
XMLHttpRequest
# states

Browser-Kompatibilität

Help improve MDN

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