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
wederdocument
noch ein leerer String ist.
Beispiele
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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
responseXML |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.
Siehe auch
XMLHttpRequest
XMLHttpRequest.response
XMLHttpRequest.responseType
- Parsen und Serialisieren von XML
- Parsen von XML in einen DOM-Baum:
DOMParser
- Serialisieren eines DOM-Baums in XML:
XMLSerializer
(insbesondere die MethodeserializeToString()
)