Configurable Object to XML converter for Node.js
Pull request Compare This branch is 37 commits behind QuickenLoans:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Easy XML

The purpose of this module is to provide an easy to use function for converting your JS objects into XML. I plan on making it configurable since a lot of different people have different expectations.

Everything in here is CPU bound and without callbacks, so feel free to run it synchronously.


$ npm install easyxml


  • singularizeChildren: If an array is plural, its children elements will be singular
  • underscoreAttributes: String attributes starting with _ will be XML attributes
  • rootElement: A string to wrap around your entire XML object
  • dateFormat: A date format for JS dates, currently accepts 'ISO 8601'
  • 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


I was working on a Node.js API, and I wanted to be able to build a single object within each of my actions, and have that object automatically converted into the appropriate response based on request type (JSON, XML). The existing object to XML converters seemed to be lacking. The biggest feature I wanted was that an array of elements with a plural name get a bunch of sub elements with the singular version of the name. This library allows for all of that. Can be configured globally as well as on a per usage basis.


Input Object:

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

Example Config:

    singularizeChildren: true,
    underscoreAttributes: true,
    rootElement: 'response',
    dateFormat: 'ISO',
    indent: 2,
    manifest: true

Output XML:

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


This project is licensed under the MIT license.