check-ip

A simple module that will take an IP address as input and perform the following:

• Validate the IP address for proper format and number range
• Remove any leading zeros in each octet
• Return a tested ("boiled") IP address
• Indicate if the IP address is part of the bogons list (https://en.wikipedia.org/wiki/Bogon_filtering)
• Indicate if the IP address is part of the multicast IP range (https://en.wikipedia.org/wiki/IP_multicast)
• Indicate if the IP address is an Automatic Private IP Address aka APIPA (http://www.webopedia.com/TERM/A/APIPA.html)
• Indicate if the IP address is an RFC1918 IP address aka private IP address (https://tools.ietf.org/html/rfc1918)
• Indicate if the IP address is a public IP address

Install

npm install check-ip

Usage

Import the module and give it the IP address to be tested as a parameter:

1var checkIp = require('check-ip');
2
3checkIp('8.8.8.8');

check-ip will return an object similar to the following:

1{ originalIp: '8.8.8.8',
2  boiledIp: '8.8.8.8',
3  isValid: true,
4  isBogon: false,
5  isApipa: false,
6  isMulticast: false,
7  isRfc1918: false,
8  isPublicIp: true }

You can use any of the properties of the returned object in your code to test for specific use cases.

Methods

• None

Examples

Working example of an IP address being tested as a valid public IP address (copy this first code snippet, save in a file and use for testing):

1var checkIp = require('check-ip');
2var ipAddress = '8.8.8.8';
3
4var response = checkIp(ipAddress);
5if (response.isValid && response.isPublicIp) {
6  console.log("IP address " + response.boiledIp + " is a valid public IP.");
7}

Example of testing an IP address to make sure it is valid and then using the boiled IP in your code:

1var checkIp = require('check-ip');
2    
3// IP address determined to be from a previously defined arguments array elsewhere.
4var ip = arg[2];
5
6var response = checkIp(ip);
7if (!response.isValid) {
8  console.log("Please enter a different IP address.  That one is not valid.");
9} else {
10  console.log("IP address " + response.boiledIp + " as a valid IP address.");
11
12  // More code goes here to use response.boiledIp in your code.
13  {...}
14
15}

Here is example output demonstrating the module 'boiling' the leading zero off of the second octet of the supplied IP address:

1{ originalIp: '10.020.30.40',
2  boiledIp: '10.20.30.40',
3  isValid: true,
4  isBogon: true,
5  isApipa: false,
6  isMulticast: false,
7  isRfc1918: true,
8  isPublicIp: false }

Testing

Run automated tests for Node.js:

npm run test