deshortify

Deshortify

NodeJS module which turns short URLs into long, meaningful, crap-less URLs

Why

Because I don't like short URLs. They don't convey information.

Because I don't like URLs with spammy URL parameters that take up space in my screen.

Because I feel that the existing de-shortening libraries for NodeJS (like unshort, or url-unshort) are lacking.

Deshortify will follow URLs, performing HTTP HEAD requests, and then it will get rid of useless URL parameters.

For example, it will turn http://bit.ly/2qzPrcN into http://www.liberation.fr/direct/element/une-elue-du-personnel-de-whirlpool-candidate-suppleante-pour-en-marche_63786/?utm_campaign=Echobox&utm_medium=Social&utm_source=Twitter#link_time=1494593774, and then into http://www.liberation.fr/direct/element/une-elue-du-personnel-de-whirlpool-candidate-suppleante-pour-en-marche_63786/#link_time=1494593774.

Deshortify will keep a cache of resolved URLs, so that known ones are not re-requested on the network.

Usage

// Import the library
import Deshortifier from '../../../deshortify/src/deshortify'

// Create an instance
let deshortifier = new Deshortifier({ verbose: true });

// Call deshortify(), which returns a Promise for a URL.
deshortifier.deshortify('https://t.co/p0N0Zl8rx6').then(u=>console.log('Final URL is ' + u));