NeatXML is XML serialization (in JavaScript) with a few handy features.
The NeatXML module exports a single function, which takes an XML Document or Element object to turn into a string, and an optional object specifying serialization options.
import NeatXML from './neatxml.js';
const xmlString = NeatXML(xmlNodeOrDoc, options);The options object accepts the following keys and values:
indent: if set to a number or string, each node in the supplied hierarchy will be placed on its own line and indented by the number of spaces (if a number) or by repetitions of the string specified by this option.strip: if set totrue, remove leading/trailing whitespace from text nodes, and ignore whitespace-only nodes altogether.sort: if set totrue, sort attributes within elements based on their name; attributes with no namespace will appear before those with a prefix.omitNS: if set to a namespace URI string, or array of URIs, all attributes, elements, and namespace declarations matching the URI(s) will be omitted from the output.cdata: if set totrue, all text nodes will be output as CDATA sections; if set tofalse, all CDATA nodes will be output as plain text.tightcdata: if this andindentaretrue, cdata nodes will start and end on the same line on their parent, with their text content on separate line(s).
When using the indent option you will likely also want to use the strip option.
NeatXML is copyright ©2018 by Gavin Kistner and is released under the MIT License. See the LICENSE.txt file for more details.
For bugs or feature requests please open issues on GitHub. For other communication you can email the author directly.
- Set up a robust test suite.
- Provide options for wrapping to set column widths.
- Provide options for formatting numeric attributes to a number of decimals.
- v0.10 [2019-Apr-21] — Add
tightcdatafeature. - v0.9 — Initial release