It's a powerfull URL parser written in JavaScript and compatible with NodeJS with a lot of features that it will help you to modify/parse easily a URL without any problem.
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).
http://jsfiddle.net/yeikos/a2LdT/
http://www.yeikos.com/2013/01/javascript-nodejs-url-parser.html
v1.2.7 - 01/03/14
URL.param and URL.unparam.v1.2.6 - 19/07/13
v1.2.5 - 18/05/13
query (alias to search)URL.attr (port).URL.param and URL.unparam.v1.2.4 - 09/02/13
URL.unparam.v1.2.3 - 15/01/13
URL.normalize.pathname: absolute path is converted to canonical.v1.2.2 - 12/01/13
_prototypeSelect: variable size was not declared.v1.2.1 - 11/01/13
instance._prototypeSelect: select, unselect, from, to.URL.normalize.host: it will be converted to lowercase.v1.2.0 - 10/01/13
unselect.v1.1.0 - 09/01/13
isExternal, select, from, to.query to search and queryHash to hash.<html>
<head>
<script type="text/javascript" src="http://files.yeikos.com/url.js"></script>
<script type="text/javascript">
var url = URL('http://guest:secret@remote:21/filename?a=1#ok');
console.log(
url.attr()
/*{
protocol: 'http:',
auth: 'guest:secret',
host: 'remote:21',
hostname: 'remote',
port: 21,
pathname: '/filename',
search: '?a=1',
hash: '#ok'
}*/
);
console.log(
url.attr('hostname')
// remote
);
console.log(
url.attr('hostname', 'localhost').href()
// http://guest:secret@localhost:21/filename?a=1#ok
);
console.log(
url.attr('query'),
// ?a=1
url.query('b', 2).query(),
// { a : 1, b : 2 }
url.attr('query')
// ?a=1&b=2
);
console.log(
url.hash({ a: 1 }).select('hostname', 'pathname', 'hash')
// //localhost/filename#a=1
);
console.log(
URL('http://localhost', 'https://localhost').isExternal(),
// true
URL('/folder', 'https://localhost').isExternal()
// false
);
console.log(
URL('subsection?a=1', 'http://localhost/section/').from('pathname')
// /section/subsection?a=1
);
</script>
</head>
<body>See console log.</body>
</html>
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.
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.
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).
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.
FAQs
It's a powerfull URL parser written in JavaScript and compatible with NodeJS with a lot of features that it will help you to modify/parse easily a URL without any problem.
The npm package kurl receives a total of 3 weekly downloads. As such, kurl popularity was classified as not popular.
We found that kurl demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Four npm packages disguised as cryptographic tools steal developer credentials and send them to attacker-controlled Telegram infrastructure.
Security News
Ruby maintainers from Bundler and rbenv teams are building rv to bring Python uv's speed and unified tooling approach to Ruby development.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.