Provides numerous methods useful for managing URIs.

Pass a string to the URI subclass and it will extend it, returning a new string-like object with new methods useful for managing that URI.

new URI([strURI, options]);

1. strURI - (string) the URI to parse into the class.
2. options - (object) a key/value set of options.

• base - (mixed) A base href for the URI (defaults to the document base location). Can be a string or an instance of URI. This is used to interpret relative urls (for instance if you were to call new URI('/foo/bar.html') the class will infer that this path is relative to the current document base location).

var myURI = new URI('http://user:password@www.test.com:8383/the/path.html?query=value#anchor');

• URI - (string; optional) - an instance of the URI class that has new methods useful for managing the URI. If not declared the window's current base location is used.

Returns the URI as a string.

myURI.toString(); //"http://www.test.com...etc"

• (string) the unaltered url.

Set's a portion of the URI to the specified value.

myURI.set(part, value);

1. type - (string, optional) url with a querystring to parse; defaults to window.location

myURI.set('scheme', 'https');
myURI.set('host', 'www.foo.com');
//etc.

• (URI) This instance of URI.

• scheme - (string) 'http', 'https', 'ftp', etc.
• user - (string) the username portion of the credentials
• password - (string) the password portion of the credentials
• host - (string) 'www.example.com', 'example.com', 'subdomain.example.com', etc.
• port - (string or integer) 80, 8080, etc.
• directory - (string) '/directory/'
• file - (string) 'file.html'
• query - (string) 'foo=bar&something=else' (the ? is added for you)
• fragment - (string) 'anAnchor' (the # is added for you)
• data - (object) an object of key/value pairs to set the query to ({foo: 'bar', something: 'else'})

Returns the current value for the specified portion of the URI.

myURI.get(part);

myURI.get('scheme'); //returns "http", for example
myURI.get('host'); //returns "www.example.com", for example

• mixed - usually returns a string, but in the case of 'data' returns an object.

• scheme - (returns string) 'http', 'https', 'ftp', etc.
• user - (string) the username portion of the credentials
• password - (string) the password portion of the credentials
• host - (returns string) 'www.example.com', 'example.com', 'subdomain.example.com', etc.
• port - (returns string) 80, 8080, etc.
• directory - (returns string) '/directory/'
• file - (returns string) 'file.html'
• query - (returns string) 'foo=bar&something=else' (the ? is added for you)
• fragment - (returns string) 'anAnchor' (the # is added for you)
• data - (returns object) an object of key/value pairs to set the query to ({foo: 'bar', something: 'else'})

Sets the query string from an object (much like myURI.set('data', obj)) but also allows merging.

myURI.setData(data[, merge, part]);

1. object - (object) the key/values you want to set for the query string
2. merge - (boolean, optional) if true the values will be merged with the existing query string. Defaults to false.
3. part - (string, optional) this defaults to 'query' for setting query string data to the URI, but you could, for example specify 'fragment' to assign query string data to the '#...' portion of the URI (which is useful in ajax applications that wish to store state in the URI without reloading the document).

myURI.setData(key, value);

1. key - (string) the key of the data which you wish to assign
2. value - (string or number) the value you wish to assign

• (URI) this instance of URI

myURI.setData(myObject); //same as myURI.set('data', myObject);
myURI.setData(myObject, true); //merges myObject w/ existing query values
myURI.setData('foo', 'bar'); //sets foo=bar in the query string
myURI.setData({foo: 'bar'}, false, 'fragment'); //adds #foo=bar to the url fragment

Returns the query string values as an object. Same as URI.get('data').

myURI.getData([key, part]);

1. key - (string; optional) If specified, returns the value for the given key.
2. part - (string; optional) If specified, returns the data from the given part (defaults to 'query'). This is useful if you choose to store data in the fragment (the '#...' part of the URI) which is useful in ajax applications that wish to store state in the URI without reloading the document.

• mixed - the string value for the given key; if key is not specified, returns an object for all the query string values.

Clears the query string values entirely.

myURI.clearData();

Loads the url into the document location.

myURI.go();

Returns the current instance of URI. Useful when a parameter type is known to be either string or URI.

// Accepts either a string or URI instance
function(uri){
    this.filename = uri.toURI().get('file');
}

Adds a method to instantiate a URI instance from a string.

Returns a URI instance.

"http://www.domain.com/etc".toURI()

• an instance of URI