web api interface
XMLSerializer
The XMLSerializer interface provides the serializeToString() method to construct an XML string representing a DOM tree.
[!NOTE] The resulting XML string is not guaranteed to be well-formed XML.
Constructor
XMLSerializer()- : Creates a new
XMLSerializerobject.
- : Creates a new
Instance methods
serializeToString()- : Returns the serialized subtree of a string.
Examples
Serializing XML into a string
This example just serializes an entire document into a string containing XML.
const s = new XMLSerializer();
const str = s.serializeToString(document);
saveXML(str);
This involves creating a new XMLSerializer object, then passing the Document to be serialized into serializeToString(), which returns the XML equivalent of the document. saveXML() represents a function that would then save the serialized string.
Inserting nodes into a DOM based on XML
This example uses the insertAdjacentHTML() method to insert a new DOM Node into the body of the Document, based on XML created by serializing an Element object.
[!NOTE] In the real world, you should usually instead call
importNode()method to import the new node into the DOM, then call one of the following methods to add the node to the DOM tree:
- The
append()/prepend()andappend()/prepend()methods.- The
replaceWithmethod (to replace an existing node with the new one)- The
insertAdjacentElement()method.
Because insertAdjacentHTML() accepts a string and not a Node as its second parameter, XMLSerializer is used to first convert the node into a string.
const inp = document.createElement("input");
const XMLS = new XMLSerializer();
const inpSerialized = XMLS.serializeToString(inp); // First convert DOM node into a string
// Insert the newly created node into the document's body
document.body.insertAdjacentHTML("afterbegin", inpSerialized);
The code creates a new <input> element by calling createElement(), then serializes it into XML using serializeToString().
Once that’s done, insertAdjacentHTML() is used to insert the <input> element into the DOM.