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 Eigenschaft XMLHttpRequest.responseXML gibt ein Document zurück, das HTML oder XML enthält, das durch die Anfrage abgerufen wurde; oder null, wenn die Anfrage erfolglos 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 Historie dieser Eigenschaft; sie funktioniert sowohl für HTML als auch für XML.

In der Regel wird die Antwort als "text/xml" geparst. Wenn der responseType auf "document" gesetzt ist 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 Content-Type nicht als "text/xml" oder "application/xml" angibt, können Sie XMLHttpRequest.overrideMimeType() verwenden, um die Daten trotzdem als XML zu parsen.

Diese Eigenschaft ist in Workern nicht verfügbar.

Wert

Ein Document, das aus dem XML oder HTML geparst wurde, das mit XMLHttpRequest empfangen wurde, oder null, wenn keine Daten empfangen wurden oder die Daten nicht XML/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

BCD tables only load in the browser

Siehe auch