XMLHttpRequest: readyState-Eigenschaft

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.

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