JavaScript/NodeJS URL v1.2.7 ================================================== What is this? -------------------------------------- It's a powerfull URL parser written in JavaScript with a lot of features that it will help you to modify/parse easily a URL without any problem. Compatible with browser JavaScript and NodeJS (https://npmjs.org/package/kurl). Demo online -------------------------------------- http://jsfiddle.net/yeikos/a2LdT/ More info -------------------------------------- http://www.yeikos.com/2013/01/javascript-nodejs-url-parser.html Changelog -------------------------------------- **v1.2.7 - 01/03/14** - Bug fix in `URL.param` and `URL.unparam`. **v1.2.6 - 19/07/13** - Updated examples. **v1.2.5 - 18/05/13** - New license: MIT. - Added to prototype: `query` (alias to `search`) - Bug fix in `URL.attr` (`port`). - Bug fix and improvements in `URL.param` and `URL.unparam`. - Tests are common to browser JavaScript and NodeJS. **v1.2.4 - 09/02/13** - Bug fix in Internet Explorer (dom elements). - Bug fix in `URL.unparam`. **v1.2.3 - 15/01/13** - Bug fix in `URL.normalize.pathname`: absolute path is converted to canonical. - Location argument now can be a URL instance. - Code more clean and lightweight. **v1.2.2 - 12/01/13** - Bug fix in `_prototypeSelect`: variable `size` was not declared. **v1.2.1 - 11/01/13** - Added to prototype: `instance`. - Constructor improved. - Bug fix in `_prototypeSelect`: `select`, `unselect`, `from`, `to`. - Bug fix in `URL.normalize.host`: it will be converted to lowercase. **v1.2.0 - 10/01/13** - Added to prototype: `unselect`. **v1.1.0 - 09/01/13** - Added to prototype: `isExternal`, `select`, `from`, `to`. - Renamed prototype methods: `query` to `search` and `queryHash` to `hash`. - URL argument now can be a DOM element. - Code more clean and lightweight. - Bug fix and optimizations. Example -------------------------------------- See console log. Attributes -------------------------------------- The attributes names match with of Location Object Properties (http://www.w3schools.com/jsref/obj_location.asp), except `href` that it's ignored, and `auth` that it`s added. Attributes: `protocol`, `auth`, `host`, `hostname`, `port`, `pathname`, `search` (or `query`), `hash`. API methods -------------------------------------- ### Constructor (URL) *** **URL(url, location)** _url: string, attributes object or DOM element (optional)._ _location: string, attributes object, DOM element or URL instance (optional)._ > Creates a new instance with an URL in base to the location introduced. returns instance. *** ### Local methods (URL.prototype) *** **url.location** > It's a URL instance added automatically by the constructor, and his attributes are used internally to calculate the result in base to the location defined. *** **url.href()** > Builds an URL string in base to current attributes values. returns URL string. **url.href(url)** _url: string, attributes object or DOM element._ > Sets a new URL that replaces all attributes. returns instance. *** **url.attr()** > Gets all attributes. returns attributes object. **url.attr(name)** _name: attribute name (string)._ > Gets value of the attribute. returns string. **url.attr(object)** _object: attributes object._ > Sets multiple values to the attributes. returns instance. **url.attr(name, value)** _name: attribute name (string)._ _value: attribute value._ > Sets a new value to the attribute. returns instance. *** **url.search()** > Gets search attribute in object format. returns object. **url.search(name)** _name: attribute name (string)._ > Gets the value of component. returns string. **url.search(object)** _object: compontents object._ > Replaces all compontents by the object introduced. returns instance. **url.search(name, value)** _name: compontent name (string)._ _value: compontent value. If it's `null` the compontent will be delete._ > Sets a new value to the compontent. returns instance. *** **url.query** > Alias to `url.search`. *** **url.hash()** > Gets hash attribute in object format. returns object. **url.hash(name)** _name: attribute name (string)._ > Gets the value of component. returns string. **url.hash(object)** _object: compontents object._ > Replaces all components by the object introduced. returns instance. **url.hash(name, value)** _name: compontent name (string)._ _value: compontent value. If it's `null` the compontent will be delete._ > Sets a new value to the compontent. returns instance. *** **url.isExternal()** > Checks if the address is external in base to the location. returns true or false (boolean). *** **url.select(name, name, ...)** _name: attributes names (string)._ > Builds an URL string using only selected attributes. returns URL (string). *** **url.unselect(name, name, ...)** _name: attributes names (string)._ > Builds an URL string excluding selected attributes. returns URL (string). *** **url.from(name)** _name: attribute name (string)._ > Builds an URL string starting from the selected attribute. returns URL (string). *** **url.to(name)** _name: attribute name (string)._ > Builds an URL string starting from the beginning to the selected attribute. returns URL (string). *** ### Global methods (URL) *** **URL.instance(argv, callback)** _argv: array argument of the constructor (optional)._ _callback: function whose context is the new instance (optional)._ > Create a new URL instance with arguments, calling first to callback and finally to constructor. returns instance. *** **URL.getElementURL(element)** _element: element object (DOM Element)._ > Gets element URL (form, a, base, link, img, script, iframe). returns URL if found or empty string if not found (string). *** **URL.build(url, location)** _url: string, attributes object or DOM element._ _location: string, attributes object, DOM element or URL instance (optional)._ > Builds a new URL based in attributes introduced and doing use location attributes. returns URL (string). *** **URL.unbuild(url, location)** _url: string, attributes object or DOM element._ _location: string, attributes object, DOM element or URL instance (optional)._ > Unbuilds URL to converting it into a attributes object and doing use location attributes. returns attributes object. *** **URL.param(query)** _query: query object._ > Converts a object into query string. returns query string. *** **URL.unparam(query)** _query: query string._ > Converts a query string into object. returns query object. ***