XMLSerializer: serializeToString()-Methode

Syntax

serializeToString(rootNode)

Parameter

rootNode

Der Node, der als Wurzel des DOM-Baums oder Teilbaums verwendet werden soll, für den eine XML-Darstellung erstellt werden soll.

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 Node oder Attr sein.

InvalidStateError DOMException

Wird ausgelöst, wenn der Baum nicht erfolgreich serialisiert werden konnte, wahrscheinlich aufgrund von Problemen mit der Kompatibilität der Inhalte mit der XML-Serialisierung.

SyntaxError DOMException

Wird ausgelöst, wenn eine Serialisierung von HTML angefordert wurde, aber aufgrund von nicht wohlgeformten Inhalten nicht erfolgreich sein konnte.

Hinweise zur Nutzung

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 Attr-Objekt sein.

Die folgenden Typen sind zusätzlich zu Node und Attr als Nachkommen des Wurzelknotens zulässig:

• DocumentType
• Document
• DocumentFragment
• Element
• Comment
• Text
• ProcessingInstruction
• Attr

Wenn ein anderer Typ angetroffen wird, wird eine TypeError-Ausnahme ausgelöst.

Hinweise zur resultierenden XML

Einige Dinge sind in Bezug auf die von serializeToString() generierte XML-Ausgabe zu beachten:

• Für XML-Serialisierungen werden Element- und Attr-Knoten immer mit ihren namespaceURI serialisiert. Dies kann bedeuten, dass ein zuvor angegebener prefix oder der Standard-Namespace möglicherweise entfernt oder geändert wird.
• Die resultierende XML-Darstellung ist mit dem HTML-Parser kompatibel.
• Elemente im HTML-Namespace, die keine Kindknoten haben (und damit leere Tags darstellen), werden mit Anfangs- und End-Tags serialisiert ("<someelement></someelement>") anstelle des leeren Tag-Formats ("<someelement/>").

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Parsing und Serialisierung von XML
• Serialisierung in HTML: Element.innerHTML und Element.outerHTML
• Parsing von HTML oder XML, um einen DOM-Baum zu erstellen: DOMParser