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 Juli 2015.
Die Methode serializeToString()
des XMLSerializer
konstruiert eine Zeichenkette, die den angegebenen DOM-Baum in XML-Form darstellt.
Syntax
serializeToString(rootNode)
Parameter
Rückgabewert
Eine Zeichenkette, die 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 entweder einNode
oder einAttr
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 aufgrund des nicht wohlgeformten Inhalts nicht erfolgreich war.
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 zusätzlich zu Node
und Attr
als Nachkommen des Wurzelknotens zulässig:
Wenn ein anderer Typ angetroffen wird, wird eine TypeError
-Ausnahme ausgelöst.
Anmerkungen zum resultierenden XML
Es gibt einige Dinge, die bezüglich der von serializeToString()
erzeugten XML-Ausgabe beachtet werden sollten:
- Für XML-Serialisierungen werden
Element
- undAttr
-Knoten immer mit ihremnamespaceURI
intakt serialisiert. Dies kann bedeuten, dass ein zuvor angegebenerprefix
oder Standard-Namensraum möglicherweise entfernt oder geändert wird. - Das resultierende XML ist mit dem HTML-Parser kompatibel.
- Elemente im HTML-Namensraum, die keine Knoten enthalten (und damit leere Tags darstellen), werden mit sowohl Anfangs- als auch End-Tags (
"<someelement></someelement>"
) anstelle des leeren-Element-Tags ("<someelement/>"
) serialisiert.
Spezifikationen
Specification |
---|
HTML # dom-xmlserializer-serializetostring |
Browser-Kompatibilität
Loading…
Siehe auch
- Parsen und Serialisieren von XML
- Serialisieren nach HTML:
Element.innerHTML
undElement.outerHTML
- Parsen von HTML oder XML zum Erstellen eines DOM-Baums:
DOMParser