XMLHttpRequest: responseXML-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 schreibgeschützte XMLHttpRequest.responseXML-Eigenschaft gibt ein Document zurück, das das HTML oder XML enthält, das durch die Anfrage abgerufen wurde, oder null, wenn die Anfrage nicht erfolgreich war, noch nicht gesendet wurde oder die Daten nicht als XML oder HTML geparst werden können.

Hinweis: Der Name responseXML ist ein Überbleibsel aus der Geschichte dieser Eigenschaft; sie funktioniert sowohl für HTML als auch XML.

In der Regel wird die Antwort als "text/xml" geparst. Wenn der responseType auf "document" gesetzt wird und die Anfrage asynchron durchgeführt wurde, wird die Antwort stattdessen als "text/html" geparst. responseXML ist für alle anderen Datentypen sowie für data: URLs null.

Wenn der Server den Content-Type nicht als "text/xml" oder "application/xml" spezifiert, können Sie XMLHttpRequest.overrideMimeType() verwenden, um die Daten trotzdem als XML zu parsen.

Diese Eigenschaft ist in Web-Workern nicht verfügbar.

Wert

Ein Document, das durch das Parsen des mit XMLHttpRequest empfangenen XML- oder HTML-Inhalts erstellt wurde, oder null, falls keine Daten empfangen wurden oder die Daten weder XML noch HTML sind.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn der responseType weder document noch ein leerer String ist.

Beispiele

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server");

// If specified, responseType must be empty string or "document"
xhr.responseType = "document";

// Force the response to be parsed as XML
xhr.overrideMimeType("text/xml");

xhr.onload = () => {
  if (xhr.readyState === xhr.DONE && xhr.status === 200) {
    console.log(xhr.response, xhr.responseXML);
  }
};

xhr.send();

Spezifikationen

Specification
XMLHttpRequest
# the-responsexml-attribute

Browser-Kompatibilität

Siehe auch