nathamanath/uri.js

Parse and stringify urls with array and object params in javascript

Javascript URL parser

URL parsing in javascript. Handles nested arrays and object url params.

Usage

// Parse a uri:
var uri = URI.parse('http://www.nathansplace.co.uk:80/javascript/uri-js/docs/?array[]=one&array[]=two&hash[key]=value#something');

=> {
  protocol: 'http:',
  host: 'www.nathansplace.co.uk',
  port: 80,
  path: ['javascript', 'uri-js', 'docs'],
  params: {
    array: ['one', 'two'],
    hash: {
      key: value
    }
  },
  hash: 'something'
}

// And put it back how you found it...
URI.stringify(uri);

=> 'http://www.nathansplace.co.uk:80/projects/javascript/uri-js/docs/?array[]=one&array[]=two&hash[key]=value#something'

Development

TODO:

• parse subdomans
• docs
• thorough cross browser testing
• seperate parse and stringify objects out from uri

Testing

Run rake test.

uri.js's Issues

Values with ampersand break parseParams

Hey, solid plugin. Parameters that have ampersands in them — eg. category=Big%20&%20Tall in the URL — cause Cannot read property 'match' of undefined from valueType's first match conditional.

Looks like the root cause is params = search.split('&'); in parseParams, as it doesn't take into account any other possible ampersands.