node package manager


Application URLs model. Replacing static string URLs with hierarchical model.


Application URLs model. Replacing static string URLs with hierarchical model.

URLs in our apps are hard-coded.

Building a hierarchical/readable model of URLs. Instead of '\home' we can write url.home(), or '\profile\'+name+'\photos' ->

Using urlset is very simple:

var path = require('path');
var urlset = require('urlset');
// sitemap.json contains configuration file for urlset
urlset.load(__dirname + '/sitemap.json');
var url = urlset.url;
// now, where we need to use link '/' we ca use:
// we can add urls programmatically:
// now we have function:
url.login(); //output: /login
// we can create more complex urls:
// we have created function 'item' in section 'news':; //output: /item-1234.html
// with extra params:,{lang:'fr',source:'fb'}); //output: /item-1234.html?lang=fr&source=fb
//var alt_urlset = new urlset.Provider(); - create a new urlset

Configuration file(s) are in json format.

  1. $url - url format for current node;
  2. $name - replace node name (by default is using node name for building url);
  3. $absolute - true for not to use parent's name in path;
  4. $root - reset as root, for childs;
"home": "/",
"item": "/item/${0}-${1}",
"account": "/account-${name}",
"accounts": {
"profile": "/profile",
"photos": "/${0}/photos",
"friends": {
"$url": "/${0}/friends"

Every url in config file can be a string(like "home": "/") or an object: "friends": { "url": "/${0}/friends" }.

This example creates:

url.home(); // with no params, output: '/'
url.item(p0,p1); // with 2 params, output: '/item/p0-p1'
url.accounts.profile(); // with no params, output: '/accounts/profile'; // with one param, output: '/accounts/p0/photos'
url.accounts.points(p0); // with one param, output: '/p0/points' !! link is absolute, so it don't adds '/accounts' prefix
url.accounts.friends(p0); // with one param, output: '/accounts/p0/friends'
url.account({name: 'uniq', lang: 'ru'}); // with one param, output: '/account-uniq?lang=ru'

All urls accept an extra param(object) for query: url.home({lang:'ru',_ref:'home'}) -> '/?lang=ru&_ref=home'

url property keeps created urls structure.

Inits urlset. Default configuration:

identifier: '$',
params: [],
formater: formats.json

Loads a file or a list of files containing urls configuration.

Adds a url to urlset: urlset.add('/map','map','utils'); creates:

We can define global special params. Special params are useful for localization, for example. If we want every link to add lang query param if lang is not default:

urlset.add('/','home'); // added url home()
urlset.setParam({name:'lang', value: 'en'});
//output: /
//output: /?lang=ro

Param structure:

name: string, //param name, required
value: ?, //param default value
useDefault: bool, //if true - will use value for every url
format:['s','q'] //'s' for start url, 'q' for query

More complex example:

urlset.add('/','home'); // added url home()
urlset.setParam({name:'lang', value: 'en', format: 's', useDefault: true});
//output: /en/
//output: /ro/

Sets a param

Removes a param by name

Gets a param by name