xml-formatter
Converts XML into a human readable format (pretty print) while respecting the xml:space
attribute.
Reciprocally, the xml-formatter
package can minify pretty printed XML.
The xml-formatter
package can also be used on the browser using the browserified version with a small footprint.
Installation
$ npm install xml-formatter
Example
Usage:
import xmlFormat from 'xml-formatter';
xmlFormat('<root><content><p xml:space="preserve">This is <b>some</b> content.</content></p>');
Output:
<root>
<content>
<p xml:space="preserve">This is <b>some</b> content.</p>
</content>
</root>
Options
filter
: Function to filter out unwanted nodes by returning false
.
- type:
function(node) => boolean
- default:
() => true
ignoredPaths
: List of XML element paths to ignore during formatting.
This can be a partial path (element tag name) or full path starting from the document element e.g. ['/html/head/script', 'pre']
.
- type:
string[]
- default:
[]
indentation
: The value used for indentation.
collapseContent
: True to keep content in the same line as the element. Only works if element contains at least one text node.
- type:
boolean
- default:
false
lineSeparator
: Specify the line separator to use.
- type:
string
- default:
\r\n
whiteSpaceAtEndOfSelfclosingTag
: True to end self-closing tags with a space e.g. <tag />
.
- type:
boolean
- default:
false
throwOnFailure
: Throw an error when XML fails to parse and get formatted otherwise the original XML is returned.
- type:
boolean
- default:
true
forceSelfClosingEmptyTag
: True to force empty tags to be self-closing.
- type:
boolean
- default:
false
Usage:
import xmlFormat from 'xml-formatter';
xmlFormat('<root><!-- content --><content><p>This is <b>some</b> content.</content></p>', {
indentation: ' ',
filter: (node) => node.type !== 'Comment',
collapseContent: true,
lineSeparator: '\n'
});
Output:
<root>
<content>
<p>This is <b>some</b> content.</p>
</content>
</root>
Minify mode
Usage:
import xmlFormat from 'xml-formatter';
const xml = `
<root>
<content>
<p>
This is <b>some</b> content.
</p>
</content>
</root>`;
xmlFormat.minify(xml, {
filter: (node) => node.type !== 'Comment',
collapseContent: true
});
Output:
<root><content><p>This is<b>some</b>content.</p></content></root>
On The Browser
The code is transpiled using Babel with @babel/preset-env default values and bundled using browserify.
Using require('xml-formatter')
Page:
<script type="text/javascript" src="dist/browser/xml-formatter.js"></script>
Usage:
const xmlFormatter = require('xml-formatter');
xmlFormat('<root><content><p xml:space="preserve">This is <b>some</b> content.</content></p>');
Using global function xmlFormatter
Page:
<script type="text/javascript" src="dist/browser/xml-formatter-singleton.js"></script>
Usage:
xmlFormatter('<root><content><p xml:space="preserve">This is <b>some</b> content.</content></p>');
Output
<root>
<content>
<p xml:space="preserve">This is <b>some</b> content.</p>
</content>
</root>
License
MIT