Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Juli 2015⁩.

Die Methode serializeToString() des XMLSerializer konstruiert 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 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:

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

Specification
HTML
# dom-xmlserializer-serializetostring

Browser-Kompatibilität

Siehe auch