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 eine Zeichenkette, die den angegebenen DOM-Baum in XML-Form darstellt.

Syntax

js
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:

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

Specification
DOM Parsing and Serialization
# dom-xmlserializer-serializetostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch