damn-simple-xml

Dams Simple XML DSX is optimized to serialize JavaScript objects and deserialize XML elements that have been formerly serialized from an object in another programming language (or by DSX). DSX is not designed to handle any kind of free form XML documents. DSX have a small memory footprint. It is the only XML library that can handle CDATA sections for both serialization and deserialization.

Google Group

Documentation and Release Notes

Consult the full API Reference for detailed documentation.

Consult The Release Notes here.

Usage

The following usage scenarios are oversimplified. with DSX, you can fine tune and control each serialization behaviors. You can choose to define a field to be serialized as an attribute, a CDATA or define a collection child elements' name. For more informations, see API Reference reference

Serialization

By default, all fields of an object will be serialized as a XML element. You can control serialization by providing a behavior object telling Damn Simple Xml how to serialize attributes texts, CDATA, arrays and arrays' items fields:

var Serializer = require("damn-simple-xml");
var serializer = new Serializer();
 
var employees = [
  { 
    id: 123,
    department: "Marketting",
    fullname: "John Doe",
    emails: [
        {
            type: "home",
            value: "[e-mail]"
        },
        {
            type: "work",
            value: "[e-mail]"
        }
    ]
  },
  { 
    id: 456,
    department: "Administration",
    fullname: "Jane Dowell",
    emails: [
        {
            type: "home",
            value: "[e-mail]"
        }
    ]
  }
];
 
var xml = "";
serializer.serialize({
  name: "employees", 
  data: employees
}, function(err, xmlpart, level) {
  if (err) {
    console.log(err);
    return;
  }
  xml += xmlpart;
  if (level === 0) {  // 0 means seialization is done
    console.log(xml);
  }
});

The previous code will result in a one line unformatted xml corresponding to:

<employees>
  <employee>
    <id>123</id>
    <department>Marketting</department>
    <fullname>John Doe</fullname>
    <emails>
      <emailsItem>
        <type>home</type>
        <value>[e-mail]</value>
      </emailsItem>
      <emailsItem>
        <type>work</type>
        <value>[e-mail]</value>
      </emailsItem>
    </emails>
  </employee>
  <employee>
    <id>456</id>
    <department>Administration</department>
    <fullname>Jane Dowell</fullname>
    <emails>
      <emailsItem>
        <type>home</type>
        <value>[e-mail]</value>
      </emailsItem>
    </emails>
  </employee>
</employees>

Deserialization

When unspecified, free text beside other XML elements is added to the "_text" field by default.

Given the following XML:

<employee>
  This employee is terrible!
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <emails>
    <email type="work">[e-mail]</email>
    <email type="personal">[e-mail]</email>
  <emails>
</employee>

var Serializer = require("damn-simple-xml");
var serializer = new Serializer();
 
serializer.deserialize(xml, function(err, root) {
  console.log(root);
});

Will display the following Javascritp object:

{
  name: "employee",
  data: {
    _text: "This employee is terrible!",
    firstName: "John",
    lastName: "Doe",
    emails: [
      {
        type: "work",
        value: "[e-mail]"
      },
      {
        type: "personal",
        value: "[e-mail]"
      }
    ]
  }
}