Router 2

A simple NodeJS server routing system.

---

This is a very simple routing system for your NodeJS RESTy apps, tested mainly with the http module.

Important Note: As of version 2, there's almost no backwards compatibility with versions prior to it (Last was 1.3.0), so if you don't want to upgrade your project, better force version 1.3.0! Also the functionality of .also has been dropped for now.

Basic usage

Chaining method

You can include a router instance globally like:

1global.Router = require('Router');

Then, you can define few routes in lately included files, or in the same file:

1//You could specify a raw regex, but you will have to specify the anchor characters!
2Router.when("/home", (req, res, m) => {
3  res.end("Hey! You're in '/home'!");
4})
5//You can specify the method to match, so if you specify this route but the method does not match, it will be ignored.
6.when("/putSomething/(.+)", ['PUT'], (req, res, m) => {
7  res.end(`Hehe, we're going to put ${m[1]}`);
8})
9//Final is now ".finally()" but .final is maintained as sugar syntax for finally.
10.finally((req, res) => {
11  res.writeHead(404, {'Content-Type': 'plain/text'});
12  res.end("Sorry, nothing found :(");
13});

If you want to pass a raw RegExp you can, like: Router.when(/^\/home$/, ...)

Note the ^ and $, they are automatically added when you pass a string, but in regex you have to define them explicitly.

Hooking method

Want to use classes? No problem, use hooks! Router.$()

1class Actrl {
2
3  static aRoute(req, m) {
4    return "Hehe, a route!";
5  }
6
7}
8Router.$("/home", Actrl.aRoute);

Easy huh? Remember that $ is a syntactic sugar for Router.hook.

You can use non-static methods also:

1class A {
2  constructor(prop){
3    this.prop = prop;
4    Router.$("/lol", this.lol);
5  }
6  lol(req, m){
7    return `Here your controller instance holds ${this.prop} property!`;
8  }
9}
10let a = new A(); //...

If you return a string, the default header is sent {'Content-Type': 'plain/text'} and the code is 200.

You can change this returning an object:

1{

2  code: 200,

3  head: {
4    {'Content-Type': 'text/html'}
5  },

6  data: `Hey! <b>Bold</b> stoopid html <i>haha</i>`
7}

All fields are optional. If you return an object with only data and this data is an object, the server will respond a 200 code with application/json content type and the object will be stringified:

1{data: {
2  "a": "json",
3  "is": [
4    "cool",
5    "very cool"
6  ]
7}}

With the Es7 spec there will be included the function decorators that use a similar syntax to java's annotations @someDec(asdasd) but untill now you will have to stick to Router.$.

For more examples, see /examples folder.