original

What is original?

The 'original' npm package is designed to provide utilities for handling URL normalization and comparison. It helps in managing and comparing URLs by normalizing them to a base form, making it easier to handle different URL formats and variations in a consistent manner.

What are original's main functionalities?

URL Normalization

This feature allows the normalization of URLs to a standard format by removing default ports, unnecessary slashes, and making the hostname lowercase.

const original = require('original');
const normalizedUrl = original('http://www.example.com:80/path');
console.log(normalizedUrl); // Outputs: 'http://example.com/path'

URL Comparison

Enables the comparison of different URLs by normalizing them into a consistent format, thus facilitating accurate comparisons.

const original = require('original');
const url1 = original('http://example.com/path');
const url2 = original('http://example.com/path/');
console.log(url1 === url2); // Outputs: true

Other packages similar to original

normalize-url

Similar to 'original', 'normalize-url' provides more extensive features for URL normalization, such as removing tracking parameters, and sorting query parameters. It offers a broader scope of normalization options compared to 'original'.

url-parse

This package offers URL parsing in addition to normalization. Unlike 'original', which focuses primarily on normalization for comparison, 'url-parse' provides detailed components of the URL, which can be useful for more complex parsing and manipulation tasks.

README

origin(al)

Original generates the origin URL for a given URL or URL object. In addition to that it also comes with a simple same function to check if two URL's have the same origin.

Install

This module is browserify and node compatible and is therefor release in the npm registry and can be installed using:

npm install --save original

Usage

In all the examples we assume that the module is loaded using:

'use strict';

var origin = require('original');

To get the origin of a given URL simply call origin function with any given URL to get origin.

var o = origin('https://google.com/foo/bar?path');

// o = https://google.com

To compare if two URL's share the same origin you can call the same method.

if (origin.same('https://google.com/foo', 'https://primus.io')) {
  console.log('same');
} else {
  console.log('guess what, google.com and primus.io are not the same origin');
}

And that's it.

License

MIT