XMLHttpRequest: response-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 response-Eigenschaft des XMLHttpRequest gibt den Inhalt des Antwortkörpers als ArrayBuffer, Blob, Document, ein JavaScript Object oder als Zeichenfolge zurück, je nach dem Wert der responseType-Eigenschaft der Anfrage.

Wert

Ein geeignetes Objekt basierend auf dem Wert von responseType. Sie können versuchen, die Daten in einem bestimmten Format anzufordern, indem Sie den Wert von responseType festlegen, nachdem Sie open() aufgerufen haben, um die Anfrage zu initialisieren, aber bevor Sie send() aufrufen, um die Anfrage an den Server zu senden.

Der Wert ist null, wenn die Anfrage noch nicht abgeschlossen oder fehlgeschlagen ist, mit der Ausnahme, dass bei der Verwendung von Textdaten mit einem responseType von "text" oder dem leeren String ("") die Antwort den bisherigen Antwortinhalt enthalten kann, während die Anfrage sich noch im LOADING readyState (3) befindet.

Beispiele

Dieses Beispiel zeigt eine Funktion, load(), die eine Seite vom Server lädt und verarbeitet. Sie funktioniert, indem ein XMLHttpRequest-Objekt erstellt wird und ein Listener für readystatechange-Ereignisse erstellt wird, sodass, wenn readyState in DONE (4) geändert wird, die response abgefragt und in die an load() übergebene Rückruffunktion übergeben wird.

Der Inhalt wird als Rohtextdaten behandelt (da hier nichts den Standard- responseType überschreibt).

js
const url = "somePage.html"; // A local page

function load(url, callback) {
  const xhr = new XMLHttpRequest();

  xhr.onreadystatechange = () => {
    if (xhr.readyState === 4) {
      callback(xhr.response);
    }
  };

  xhr.open("GET", url, true);
  xhr.send("");
}

Spezifikationen

Specification
XMLHttpRequest
# the-response-attribute

Browser-Kompatibilität

Siehe auch