XMLSerializer: serializeToString()-Methode

rootNode

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

Ein String, der die XML-Darstellung des angegebenen DOM-Baums enthält.

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 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.

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:

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

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

Es gibt einige Punkte, die bezüglich des von serializeToString() ausgegebenen XML beachtenswert sind:

• Für XML-Serialisierungen werden Element- und Attr-Knoten immer mit ihrem namespaceURI serialisiert. Dies kann bedeuten, dass ein zuvor angegebener prefix 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/>").

• Parsen und Serialisieren von XML
• Serialisierung zu HTML: Element.innerHTML und Element.outerHTML
• Parsen von HTML oder XML zur Erstellung eines DOM-Baums: DOMParser