XMLHttpRequest: readyState-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: Dieses Feature ist verfügbar in Web Workers, außer in Service Workers.

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

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

Specification
XMLHttpRequest Standard # states

Browser-Kompatibilität

BCD tables only load in the browser