URI.js is a facility for working with URLs. It offers a "jQuery-style" API to read and write all regular components and a number of convenience methods like .directory() and .authority().
URI.js offers simple, yet powerful ways of working with query string, has a number of URI-normalization functions and converts relative/absolute paths.
How do you like manipulating URLs the "jQuery-style"?
// mutating URLs
URI("http://example.org/foo.html?hello=world")
.username("rodneyrehm")
// -> http://[email protected]/foo.html?hello=world
.username("")
// -> http://example.org/foo.html?hello=world
.directory("bar")
// -> http://example.org/bar/foo.html?hello=world
.suffix("xml")
// -> http://example.org/bar/foo.xml?hello=world
.search("")
// -> http://example.org/bar/foo.xml
.tld("com")
// -> http://example.com/bar/foo.xml
.search({ foo: "bar", hello: ["world", "mars"] });
// -> http://example.com/bar/foo.xml?foo=bar&hello=world&hello=mars
How do you like working query strings?
URI("?hello=world")
.addSearch("hello", "mars")
// -> ?hello=world&hello=mars
.addSearch({ foo: ["bar", "baz"] })
// -> ?hello=world&hello=mars&foo=bar&foo=baz
.removeSearch("hello", "mars")
// -> ?hello=world&foo=bar&foo=baz
.removeSearch("foo")
// -> ?hello=world
How do you like relative paths?
URI("/relative/path")
.relativeTo("/relative/sub/foo/sub/file")
// -> ../../../path
.absoluteTo("/relative/sub/foo/sub/file");
// -> /relative/path
How do you like cleaning things up?
URI("?&foo=bar&&foo=bar&foo=baz&")
.normalizeSearch();
// -> ?foo=bar&foo=baz
URI("/hello/foo/woo/.././../world.html")
.normalizePathname();
// -> /hello/world.html
URI.js is published under the MIT license and GPL v3.