route-sort
A tiny (200B) utility to sort route patterns by specificity.
This module is available in three formats:
- ES Module:
dist/rsort.mjs
- CommonJS:
dist/rsort.js
- UMD:
dist/rsort.min.js
Install
$ npm install --save route-sort
Usage
import rsort from 'route-sort';
const routes = ['/authors', '/authors/*', '/authors/:username/posts', '/authors/:username'];
const output = rsort(routes);
console.log(routes);
console.log(routes === output);
API
rsort(patterns)
Returns: Array<String>
Returns the same patterns
you provide, sorted by specificity.
Important: Your original array is mutated!
patterns
Type: Array<String>
A list of route pattern strings.
Route Patterns
The supported route pattern types are:
- static –
/users
- named parameters –
/users/:id
- nested parameters –
/users/:id/books/:title
- optional parameters –
/users/:id?/books/:title?
- suffixed parameters –
/movies/:title.mp4
, /movies/:title.(mp4|mov)
- wildcards –
/users/*
Specificity
While this working definition may not apply completely across the board, route-sort
is meant to sort Express-like routing patterns in a safe manner, such that a serial traversal of the sorted array will always give you the most specific match.
You may use regexparam
to convert the patterns into RegExp
instances, and then use those to test an incoming URL against the patterns. We'll do that in the example below:
import rsort from 'route-sort';
import toRegExp from 'regexparam';
const routes = ['/authors', '/authors/*', '/authors/:username/posts', '/authors/:username'];
rsort(routes);
function find(path) {
for (let i=0; i < routes.length; i++) {
let { pattern } = toRegExp(routes[i]);
if (pattern.test(path)) return routes[i];
}
return false;
}
find('/authors');
find('/authors/lukeed');
find('/authors/foo/bar/baz');
find('/authors/lukeed/posts');
find('/hello/moto');
Related
License
MIT © Luke Edwards