route-trie

route-trie

A trie-based URL router.

About trie

Trie-based request routing

It is a different implementation from routington

route-trie is a trie-based URL router. Its goal is only to define and match URLs. It does not handle methods, headers, controllers, views, etc., in anyway. It is faster than traditional, linear, regular expression-matching routers, although insignficantly, and scales with the number of routes.

The purpose of this router isn't for performance, but to bring more structure to URL routing. The intention is for you to build a framework on top either in node.js or in the browser.

Implementations:

• toa-router A trie router for toa(server).
• hirouter HTML5 history and router, simple, powerful and no framework(browser).

Browser Support

IE9+

Demo

Installation

Node.js:

npm install route-trie

Bower:

bower install route-trie

API

var Trie = require('route-trie');

Trie([flagI])

Create a trie.

• flagI: {Boolean}, default false, ignore case

return trie object.

var trie1 = new Trie();
var trie2 = new Trie(true); // ignore case for match

Trie.prototype.define(pattern)

Define a node for the pattern, The same pattern will always return the same node. The result node, will be an emtpy object, it has a private and not enumerable property _nodeState. _nodeState is a object that have name, pattern, childNodes and so on. You can mount properties and methods on the node, but not on _nodeState.

• pattern: {String}, each fragment of the pattern, delimited by a /, can have the following signature:

  • string - ex /post
  • string|string - | separated strings, ex /post|task
  • :name - Wildcard route matched to a name, ex /:type
  • prefix:name - Wildcard route matched to a name, ex /api:type
  • (regex) - A regular expression match without saving the parameter (not recommended), ex /(post|task), /([a-z0-9]{6})
  • :name(regex)- Named regular expression match ex /:type/:id([a-z0-9]{6})
  • prefix:name(regex)- Named regular expression match ex /api:type/:id([a-z0-9]{6})
  • * - Match remaining path without saving the parameter (not recommended), ex /* will match all path.
  • :name(*)- Named regular expression match, match remaining path, ex /:type/:other(*) will match /post/x or /task/x/y or /any/x/y/z...

return a node object.

var node = trie.define('/:type/:id([a-z0-9]{6})');
// assert(node._nodeState.pattern === '/:type/:id([a-z0-9]{6})');
// assert(node !== trie.define('/:type'));
// assert(node !== trie.define('/post'));
// assert(node === trie.define('/:type/:id([a-z0-9]{6})'));
// assert(trie.define('/:type') === trie.define('/:type1'));

Trie.prototype.match(path[, multiMatch])

• path: {String}, URL pathname to match and get the defined node
• multiMatch: {Boolean}, Optional, default: false. If true, a path maybe matched one more nodes.

Return matched object:

• Default mode: return null if no node matched, otherwise return an object with the following properties:

  • params: {Object}, A list of named parameters, ex, match.params.id === 'abc123'.
  • node: {Object}, The matched node.

  var node = trie.define('/:type/:id([a-z0-9]{6}');
  var match = trie.match('/post');
  // assert(match === null);
  
  match = trie.match('/post/abc123');
  // assert(match.node === node);
  // assert.deepEqual(match.params, {type: 'post', id: 'abc123'})
  

• multiMatch mode: will always return an object with the following properties:

  • params: {Object}, A list of named parameters.
  • nodes: {Array}, if no node matched, it will be a empty array, otherwise will be a array of matched nodes.