xmldom 0.1.30

XMLDOM is a JavaScript-based module that adheres to the W3C standard. It primarily implements the DOMParser and XMLSerializer interface in a similar way as in the browser. This makes it an ideal solution for manipulating XML documents within various JavaScript environments, such as Node.js, Rhino, and others. The functionality provided by the xmldom package ranges from basic operations like parsing an XML string into an XML Document object (DOM), modifying that document, and then serializing it back into an XML string. By achieving full compatibility with W3C's DOM level 2, and some compatibility with level 3, xmldom ensures adherence to standardized practices for XML document handling.

To use xmldom in your JavaScript project, first, you need to install it using npm, as shown below:

npm install xmldom

Then, you can import the package and use it in your code. Here's an example of how you can parse an XML string into a DOM and then work with it:

const { DOMParser } = require('xmldom');

const doc = new DOMParser().parseFromString(
    '<xml xmlns="a" xmlns:c="./lite">\n' +
        '\t<child>test</child>\n' +
        '\t<child></child>\n' +
        '\t<child/>\n' +
        '</xml>',
    'text/xml'
);
doc.documentElement.setAttribute('x', 'y');
doc.documentElement.setAttributeNS('./lite', 'c:x', 'y2');
console.info(doc);

const nsAttr = doc.documentElement.getAttributeNS('./lite', 'x');
console.info(nsAttr);

You can also serialize an XML document back into a string using the XMLSerializer:

const { DOMParser, XMLSerializer } = require('xmldom');

const doc = new DOMParser().parseFromString('<root/>', 'text/xml');
const serializer = new XMLSerializer();
const xmlStr = serializer.serializeToString(doc);
console.info(xmlStr); // logs: <root/>

These examples show basic usage, but xmldom provides a full suite of methods for interacting with XML documents, including methods for CRUD operations on XML nodes, handling XML namespaces, dealing with XML errors, and more.

The documentation for xmldom is available both directly within the npm package details page and on the GitHub repository. The docs detail the API reference, including the DOMParser and XMLSerializer interfaces, as well as other aspects like DOM level 2 methods and attributes, DOM level 3 support, and exceptions. The xmldom documentation is a comprehensive guide that assists users with different levels of XML manipulation, providing both conceptual understanding and practical usage examples.