Normalize a URL
Useful when you need to display, store, deduplicate, sort, compare, etc, URLs.
$ npm install --save normalize-url
const normalizeUrl = require('normalize-url');
normalizeUrl('sindresorhus.com');
//=> 'http://sindresorhus.com'
normalizeUrl('HTTP://xn--xample-hva.com:80/?b=bar&a=foo');
//=> 'http://êxample.com/?a=foo&b=bar'
Type: string
URL to normalize.
Type: boolean
Default: true
Prepend http:
to the URL if it's protocol-relative.
normalizeUrl('//sindresorhus.com:80/');
//=> 'http://sindresorhus.com'
normalizeUrl('//sindresorhus.com:80/', {normalizeProtocol: false});
//=> '//sindresorhus.com'
Type: boolean
Default: true
Remove the fragment at the end of the URL.
normalizeUrl('sindresorhus.com/about.html#contact');
//=> 'http://sindresorhus.com/about.html'
normalizeUrl('sindresorhus.com/about.html#contact', {stripFragment: false});
//=> 'http://sindresorhus.com/about.html#contact'
Type: boolean
Default: true
Remove www.
from the URL.
normalizeUrl('http://www.sindresorhus.com/about.html#contact');
//=> 'http://sindresorhus.com/about.html#contact'
normalizeUrl('http://www.sindresorhus.com/about.html#contact', {stripWWW: false});
//=> 'http://www.sindresorhus.com/about.html#contact'
Type: Array[RegExp|String]
Default: []
Remove query parameters which are either equal to one of the given strings or match one of the regular expressions.
normalizeUrl('www.sindresorhus.com?foo=bar&utm_medium=test&ref=test_ref', {
stripWWW: false,
ignoredQueryParameters: [/^utm.+/i, 'ref']
});
//=> 'http://www.sindresorhus.com/?foo=bar'
- compare-urls - Compare URLs by first normalizing them
MIT © Sindre Sorhus