XMLSerializer: serializeToString() Methode

Syntax

serializeToString(rootNode)

Parameter

rootNode

Der Node, der als Wurzel des DOM-Baums oder Teilbaums verwendet wird, 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 ein Node oder ein 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 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:

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

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- und Attr-Knoten immer mit ihrem namespaceURI intakt serialisiert. Dies kann bedeuten, dass ein zuvor angegebener prefix 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

Browser-Kompatibilität

Siehe auch

• Parsen und Serialisieren von XML
• Serialisieren nach HTML: Element.innerHTML und Element.outerHTML
• Parsen von HTML oder XML zum Erstellen eines DOM-Baums: DOMParser