Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

check-http-status

trunkcode516MIT1.3.0

Check HTTP Status and create a list for all the HTTP status code.

http status, redirect chain, link checker, status, redirects, 301, 404

readme

check-http-status

NPM version Downloads Build Status

Easily check status codes, response headers, and redirect chains in Node.js similar as done from the httpstatus website.

When the site is on VPN so this is where it plays an important role. You can simply connect your system/machine with VPN and run this package locally so it can check the status of your VPN connected URL(s).

It can also check the website that are secured with HTTP Authentication.

Install

Via npm

npm install check-http-status --save-dev

Via Yarn

yarn add check-http-status --dev

Examples

Status Code of the Sitemap(s) URL(s)

const checkHttpStatus = require('check-http-status');

checkHttpStatus({
    'sitemaps':  [
    'https://www.trunkcode.com/page-sitemap.xml',
    'https://www.trunkcode.com/post-sitemap.xml'
  ],
    'skip200': true, // Do not report the URLs having HTTP code 200.
  'export': {
    'format': 'xlsx',
    'location': '/Users/trunkcode/Desktop/',
  },
  'options': {
    'auth': {
      'password': 'Testing1234',
      'username': 'trunkcode'
    },
    'headers': {
      'Accept': 'text/html',
    }
  }
});

Status Code of the particular URL(s)

const checkHttpStatus = require('check-http-status');

checkHttpStatus({
    'urls': [
    'http://trunkcode.com/',
    'https://example.com/',
    'https://example1234.com/',
    'https://www.trunkcode.com/',
    'https://www.trunkcode.com/test/'
  ],
    'skip200': true, // Do not report the URLs having HTTP code 200.
  'export': {
    'format': 'xlsx',
    'location': '/Users/trunkcode/Desktop/',
  },
  'options': {
    'auth': {
      'password': 'Testing1234',
      'username': 'trunkcode'
    },
    'headers': {
      'Accept': 'text/html',
    }
  }
});

Status Code of the Sitemap(s) URL(s) with particular URL(s)

const checkHttpStatus = require('check-http-status');

checkHttpStatus({
    'sitemaps':  [
    'https://www.trunkcode.com/page-sitemap.xml',
    'https://www.trunkcode.com/post-sitemap.xml'
  ],
    'urls': [
    'http://trunkcode.com/',
    'https://example.com/',
    'https://example1234.com/',
    'https://www.trunkcode.com/',
    'https://www.trunkcode.com/test/'
  ],
    'skip200': true, // Do not report the URLs having HTTP code 200.
  'export': {
    'format': 'xlsx',
    'location': '/Users/trunkcode/Desktop/',
  },
  'options': {
    'auth': {
      'password': 'Testing1234',
      'username': 'trunkcode'
    },
    'headers': {
      'Accept': 'text/html',
    }
  }
});

Parameters

Attributes Type Required Default Description
sitemaps Array Yes | Sitemap(s) URL(s) where the Actual site URL(s) needs to be fetched for checking the HTTP Status.
urls Array Yes | URL(s) for which HTTP Status needs to be checked.
skip200 Boolean No false Whether to list the HTTP status 200 URL(s) or not.
export Object No {} Whether to export the status report or not. By default it logs the report on the screen.
options Object No {} Define options like HTTP Auth credentials if the site is locked or headers etc.

NOTE: sitemaps or urls is required. You can define both parameters as well to fetch URL(s) from sitemap and the URL(s) that are not listed in the ssitemap, you can provide them separately.

changelog

check-http-status changelog

1.3.0 - Oct 15, 2021

Enhancement

  • Allow Sitemap(s) and particular URL(s) together
  • Limit Promise to max. 10 concurrent requests
  • Show progress of the HTTP Status list

1.2.0 - May 21, 2021

Enhancement

  • Allow to add multiple sitemap URLs to fetch the list of pages.

1.1.0 - May 18, 2021

Enhancement

  • Skipping the URLs from the list that are returning HTTP code 200 to reduce the length of the list.

1.0.0 - Apr 22, 2021

  • Initial Release