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 einen String, der 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

Ein String, der 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 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.

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 auch als Nachkommen des Wurzelknotens zulässig, zusätzlich zu Node und Attr:

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

Hinweise zum resultierenden XML

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/>").

Spezifikationen

Specification
DOM Parsing and Serialization
# dom-xmlserializer-serializetostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch