path-parser

path-parser

A small utility to parse and build paths. It can be used to partially or fully match paths against a defined pattern.

Partial match allows to determine if a given path starts with the defined pattern. It is used by route-node

Usage

var Path = require('path-parser');
// Defining a new path
var p = new Path('/users/profile/:id');
// Matching
p.match('/users/profile/00123')               // => {id: "00123"}
// Partial matching: does this path
// starts with that pattern?
p.partialMatch('/users/profile/00123/orders') // => {id: "00123"}
p.partialMatch('/profile/00123/orders')       // => false
// Building
p.build({id: '00123'})                       // => "users/profile/00123"

Defining parameters

• :param: for URL parameters
• ;param: for matrix parameters
• *splat: for parameters spanning over multiple segments. Handle with care
• ?param1&param2 or ?:param1&:param2: for query parameters. Colons : are optional

Parameter constraints

For URL parameters and matrix parameters, you can add a constraint in the form of a regular expression. Note that back slashes have to be escaped.

• :param<\\d+> will match numbers only for parameter param
• ;id<[a-fA-F0-9]{8} will match 8 characters hexadecimal strings for parameter id

Constraints are also applied when building paths, unless specified otherwise (set second argument of build to true).

// Path.build(params, ignore)
var Path = new Path('/users/profile/:id<\d+>');

path.build({id: 'not-a-number'});       // => Will throw an error
path.build({id: 'not-a-number'}, true); // => '/users/profile/not-a-number'

Related modules

• route-parser
• url-pattern

Changelog

0.1.1 (2015-07-22)

<a name="0.1.0"></a>