XMLSerializer: serializeToString()-Methode
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.
Die XMLSerializer
-Methode serializeToString()
erstellt einen String, der den angegebenen DOM-Baum in XML-Form darstellt.
Syntax
serializeToString(rootNode)
Parameter
Rückgabewert
Ein String, der die XML-Darstellung des angegebenen DOM-Baums enthält.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn der angegebene
rootNode
kein kompatibler Knotentyp ist. Der Wurzelknoten muss entwederNode
oderAttr
sein. InvalidStateError
DOMException
-
Wird ausgelöst, wenn der Baum nicht erfolgreich serialisiert werden konnte, wahrscheinlich aufgrund von Problemen mit der Kompatibilität des Inhalts mit der XML-Serialisierung.
SyntaxError
DOMException
-
Wird ausgelöst, wenn eine Serialisierung von HTML angefordert wurde, aber nicht gelingen konnte, weil der Inhalt nicht wohlgeformt ist.
Anwendungshinweise
Kompatible Knotentypen
Der angegebene Wurzelknoten—und alle seine Nachkommen—müssen mit dem XML-Serialisierungsalgorithmus kompatibel sein. Der Wurzelknoten selbst muss entweder ein Node
oder ein Attr
-Objekt sein.
Die folgenden Typen sind auch als Nachkommen des Wurzelknotens zulässig, zusätzlich zu Node
und Attr
:
Wenn ein anderer Typ angetroffen wird, wird eine TypeError
-Ausnahme ausgelöst.
Hinweise zum resultierenden XML
Es gibt einige Punkte, die bezüglich des von serializeToString()
ausgegebenen XML beachtenswert sind:
- Für XML-Serialisierungen werden
Element
- undAttr
-Knoten immer mit ihremnamespaceURI
serialisiert. Dies kann bedeuten, dass ein zuvor angegebenerprefix
oder Standard-Namensraum entfernt oder geändert wird. - Das resultierende XML ist mit dem HTML-Parser kompatibel.
- Elemente im HTML-Namensraum, die keine Kindknoten haben (damit leere Tags darstellen), werden mit sowohl Anfangs- als auch End-Tags (
"<someelement></someelement>"
) serialisiert, anstelle des leeren Elemente-Tags ("<someelement/>"
).
Spezifikationen
Specification |
---|
DOM Parsing and Serialization # dom-xmlserializer-serializetostring |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Parsen und Serialisieren von XML
-
Serialisierung zu HTML:
Element.innerHTML
undElement.outerHTML
- Parsen von HTML oder XML zur Erstellung eines DOM-Baums:
DOMParser