libxmljs-easy

libxmljs-easy
=============

libxmljs-easy is a Node.js module which simplifies XML traversing,
similar to E4X.


Installation
------------

npm install libxmljs-easy

Usage
-----

Note that latest version requires Node.js 0.11.x or 0.12.x and --harmony-proxies option.
0.1.x versions of this module used node-proxy module instead.

Use module

var easy = require("libxmljs-easy");

Parse XML

var xml = easy.parse('' +
'' +
'English' +
'');

Select elements from collections explicitly

assert.equal(xml.book[0].$name, "Lord of the Rings");
assert.equal(xml.book[0].author[0].$name, "J. R. R. Tolkien");

Use shorthands (works well for case when there is single child element with given name)

assert.equal(xml.book.$name, "Lord of the Rings");
assert.equal(xml.book.author.$name, "J. R. R. Tolkien");

Basically the idea is that you construct a path from tag names,
which can optionally end with attribute name prefixed with "$".

When index is ommited – the array of elements is matched.
When attribute is accessed on such array, its value is concatenated string
of attribute values for each of elements in the array.

There is also original DOM element available as "$" property
of individual converted elements.

assert.equal(xml.book.language[0].$.text(), "English");

Further info
------------

* Annotated source with docs,
generated using Docco
* Unit tests