Configurable Object to XML converter for Node.js
Clone or download
Pull request Compare This branch is 4 commits ahead, 36 commits behind tlhunter:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Easy XML

Highly configurable Object to XML converter for Node.


$ npm install easyxml


var EasyXml = require('easyxml');

var serializer = new EasyXml({
    singularizeChildren: true,
    allowAttributes: true,
    rootElement: 'response',
    dateFormat: 'ISO',
    indent: 2,
    manifest: true

var obj = {
    items: [{
        name: 'one',
        _id: 1
    }, {
        name: 'two',
        _id: 2
    }, {
        name: 'three',
        _id: 3
    blah: '',
    when: new Date(),
    boolz: true,
    nullz: null


This should output the following XML document:

<?xml version='1.0' encoding='utf-8'?>
    <item id="1">
    <item id="2">
    <item id="3">
  <nullz />


  • singularizeChildren: If an array is plural, its children elements will be singular
  • allowAttributes: String attributes starting with _ will be XML attributes
  • attributePrefix: Prefix to look for when creating attributes
  • rootElement: A string to wrap around the rendered XML document
  • rootArray: If the root element is an array, this wraps the XML document. Should be plural
  • dateFormat: A date format for JS dates, currently accepts ISO, SQL, JS
  • indent: A number representing the spaces to indent children, use 0 for no whitespace
  • manifest: Whether or not to add that XML manifest line to the top
  • unwrappedArrays: TODO: Document
  • filterNulls: Should nulls and undefines be removed from the rendered XML


This project is licensed under a Dual BSD/GPL license.