node-em

The em extends few core NodeJS modules with simpler object oriented interface and immutable objects.

• em.URL extends Node's core url module
• em.Path extends Node's core path module

Installation

It can be installed directly from NPM:

npm install em

License

Open source, MIT-style license.

Examples

URL

You can create instances of URL by calling URL.create(path) or new URL(path).

However URL.create() only creates new objects when it must. For example when called with an another instance of URL it can simply return it since it's immutable and cannot be changed.

Each method of URL returns an another URL object so you can chain its methods:

var url = URL.create('http://www.jhh.me/')
    .resolve('/2012/12/24/setting-up-http-server-on-windows-with-node-js/');
console.log(url.href);

One of the coolest features of URL is that parsing can be done just in time on demand. In the previous example the URL wasn't parsed until you requested url.href! However if you need you can call url.parse() and get a real object with no magic members and JIT.

Path

The Path works the same way.

You can create objects by calling Path.create('/foo/bar') or new Path('/foo/bar'). Paths are immutable, too.

var path = Path.create('/foo').join('bar/docroot/').join('index.html');
console.log('dirname: '+path.dirname());         // Returns '/foo/bar/docroot'
console.log('pathname: '+path.basename('.html')); // Returns 'index'

Further examples

At the moment for further details please take a look at tests.

Reference

require('em').URL

new URL(value, opts, flags)

URL.create(value, opts, flags)

URL.prototype.toString()

URL.prototype.toJSON()

URL.prototype.resolve(to)

URL.prototype.parse()

URL.parse(url)

URL.format(url)

require('em').Path

new Path(value)

Path.create(value)

Path.prototype.toString()

Path.prototype.toJSON()

Path.prototype.resolve(...)

Path.prototype.relative(to)

Path.prototype.dirname()

Path.prototype.basename(ext)

Path.prototype.extname()

Path.prototype.join(...)

Path.join(...)