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 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 wenn 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 für XML.

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

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

Diese Eigenschaft ist in Workern nicht verfügbar.

Wert

Ein Document aus dem Parsen des XML oder HTML, 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 Standard
# the-responsexml-attribute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch