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
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
- XML parsen und serialisieren
- Parsen von XML in einen DOM-Baum:
DOMParser
- Serialisierung eines DOM-Baums in XML:
XMLSerializer
(insbesondere die MethodeserializeToString()
)