Skip to content

A simple command-line utility that lets you follow redirects to see where http URLs end up. Useful for shortened URLs.

Notifications You must be signed in to change notification settings

sthnaqvi/follow-redirect-url

Repository files navigation

follow-redirect-url

NPM

Node version npm version Build Status Coverage Dependency Status Known npm Vulnerabilities Known Vulnerabilities Downloads Total Downloads Monthly

A simple command-line utility that lets you follow redirects to see where http URLs end up. Useful for shortened URLs.

Follows up to 20 redirects Default.

Also added User-Agent header to requests, some web address won't redirect without browsers information eg: https://fb.me

Table of contents

Installation

Install with npm globally (For CLI):

npm install -g follow-redirect-url

Install for your project:

npm install -save follow-redirect-url

back to top


Usage

CLI:

follow https://bit.ly/2X7gCIT

Module:

The first argument is a url string.

'use strict';

const followRedirect = require('follow-redirect-url');

followRedirect.startFollowing('https://bit.ly/2X7gCIT').then(urls => {
    console.log(urls);
}).catch(error => {
    console.log(error)
})

back to top


Output

CLI Result:

https://bit.ly/2X7gCIT -> 301
http://github.com/sthnaqvi/follow-redirect-url -> 301
https://github.com/sthnaqvi/follow-redirect-url -> 200

Project Result:

[ { url: 'https://bit.ly/2X7gCIT',
    redirect: true,
    status: 301,
    redirectUrl: 'http://github.com/sthnaqvi/follow-redirect-url' },
  { url: 'http://github.com/sthnaqvi/follow-redirect-url',
    redirect: true,
    status: 301,
    redirectUrl: 'https://github.com/sthnaqvi/follow-redirect-url' },
  { url: 'https://github.com/sthnaqvi/follow-redirect-url',
    redirect: false,
    status: 200 } ]

back to top


Options

CLI options:

Under development

Module options:

The second argument is an options object. Options are optional.

  • max_redirect_length - maximum redirection limit. Default: 20
  • request_timeout - request timeout in milliseconds. Default: 10000
  • ignoreSslErrors - ignore SSL certificate errors when following redirects. Default: false
const followRedirect = require('follow-redirect-url');

const options = {
    max_redirect_length: 5,
    request_timeout: 5000,
    ignoreSsslErrors: true
};

followRedirect.startFollowing('https://bit.ly/2X7gCIT', options).then(urls => {
    console.log(urls);
}).catch(error => {
    console.log(error)
})

back to top

About

A simple command-line utility that lets you follow redirects to see where http URLs end up. Useful for shortened URLs.

Resources

Stars

Watchers

Forks

Packages

No packages published