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

import Path from 'path-parser';
// Defining a new path
const 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')       // => null
// Building
p.build({id: '00123'})                       // => "users/profile/00123"

Without new:

import Path from 'path-parser';

const p = Path.createPath('/users/profile/:id');

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.
• ?param1=a&param1=b will result in {param1: ['a', 'b']}
• ?param1[]=a and ?param1[]=a&param1[]=b will result respectively in {param1: ['a']} and {param1: ['a', 'b']}

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 option flag ignoreConstraints to true).

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

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

Optional trailing slashes

When using .match() or .partialMatch(), you can path a second argument. If truthy, it will make trailing slashes optional.

var path = new Path('/my-path');

path.match('/my-path/')       // => null
path.match('/my-path/', true) // => {}

Related modules

• route-parser
• url-pattern

Changelog

1.0.2 (2016-01-06)

Bug Fixes

• improve full path matching of a path with query params (ada3897)

<a name="1.0.1"></a>