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 von XMLHttpRequest gibt den Inhalt des Antwortkörpers als ArrayBuffer, ein Blob, ein Document, ein JavaScript-Object oder einen String zurück, abhängig vom Wert der responseType-Eigenschaft der Anforderung.

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 nach dem Aufruf von open() zur Initialisierung der Anfrage, aber vor dem Aufruf von send() zur Übermittlung der Anfrage an den Server, setzen.

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

Beispiele

Dieses Beispiel zeigt eine Funktion, load(), die eine Seite vom Server lädt und verarbeitet. Sie funktioniert, indem sie ein XMLHttpRequest-Objekt erstellt und einen Listener für readystatechange Ereignisse erstellt, sodass bei einer Änderung des readyState auf DONE (4) die response abgerufen und an die an load() übergebene Rückruffunktion übergeben wird.

Der Inhalt wird als Rohtextdaten behandelt (da hier nichts den Standardwert von 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 Standard
# the-response-attribute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch