What it is?

This is a simple function that I've written as a jQuery plugin. It simply takes a url as a string and returns an Object with useful attributes, much the same way that window.location does but with a bit more detail. Also window.location only gives you the current page url.

Often when dealing with asynchronous calls and ajax history, you need to do a lot url parsing. This method solves that problem. You could extend the window.location object with this function but I'm not sure about messing with prototyping native javascript methods.

Using the current url in javascript encourages the use of your beautiful RESTful interface right?

Version

Current version is 0.1 :)

Installation

Just drop the compressed file in to your page after jquery has been included.

Example Usage as a jquery plugin

$('body').parseURL(window.location.href);

Example output

{
	categorySlug: "spenoir",
	host: "www.github.com",
	parts: ["spenoir", "parseURL"],
	path: "spenoir/parseURL",
	protocol: "https:",
	url: "https://www.github.com/spenoir/parseURL"
}


var url = $('body').parseURL("https://www.github.com/spenoir/parseURL?foo=bar#spenoir");

{
	categorySlug: "spenoir",
	host: "www.github.com",
	parts: ["spenoir", "parseURL"],
	path: "spenoir/parseURL",
	protocol: "https:",
	url: "https://www.github.com/spenoir/parseURL",
	hash: "spenoir",
	queryString: ["foo", "bar"]
}

Example Usage with no argument

$('a.link').parseURL();

If you pass no argument then parseURL will try to take the previous elements href attribute.

Another example

var parsed_slug_arr = $('body').parseURL(window.location.href).parts;
parsed_slug_arr.pop();
parsed_slug_arr.push('slug_replacement');
var url = '/'+parsed_slug_arr.join('/'); //you'll probably want the leading slash, might incorportate this

In the pipeline

Demos, jasmine tests, example of extending window.location.