uri-template-lite

@version    0.1.8
@date       2014-05-21
@stability  2 - Unstable

URI Template –

URI Template [RFC 6570][rfc-6570] implementation in less than 1kb.

Installation

To use it in the browser, include uri-template-min.js in your site

<script src=uri-template-min.js></script>

In node.js: npm install uri-template-lite

var URI = require("uri-template-lite").URI

Usage

Simple expand

var data = {"domain":"example.com", "user":"fred", "query":"mycelium"}
URI.expand("http://{domain}/~{user}/foo{?query,number}", data)
// http://example.com/~fred/foo?query=mycelium

Using Template constructor

var template = new URI.Template("http://{domain}/~{user}/foo{?query,number}")
var data = {"domain":"example.com", "user":"fred", "query":"mycelium", "number": 3}
template.expand(data)
// http://example.com/~fred/foo?query=mycelium&number=3
template.match("http://example.com/~fred/foo?query=mycelium&number=3")
// {"domain":"example.com", "user":"fred", "query":"mycelium", "number": "3"}
template.match("http://other.com/?query=mycelium")
// false

About error handling

This implementation tries to do a best effort template expansion and leaves erroneous expressions in the returned URI instead of throwing errors. So for example, the incorrect expression {unclosed will return {unclosed as output.

Browser Support

• For older browsers it requires browser-upgrade-lite package or other ES5 polyfill.
• FF3-4 escape should be patched to remove non-standard 2nd param, browser-upgrade-lite does that.

External links

• Source-code on Github
• Package on npm
• RFC 6570 - URI Template

Licence

Copyright (c) 2014 Lauri Rooden <[e-mail]>
The MIT License