Quickly parses IP addresses, allowing them to be checked for CIDR matches.
Converts IPv4 to IPv6 to keep the process seamless and allow transitional IPs.
npm install ipcheck --save
To easily check an IP and a CIDR without any extra thrills...
var IPCheck = require('ipcheck'); IPCheck.match('192.168.0.1', '192.168.0.1/32'); //= trueAllows you to individually validate and re-use different IPs.
var IPCheck = require('ipcheck'); var ip = new IPCheck('192.168.0.1'); var cidr = new IPCheck('192.168.0.1/32'); ip.match(cidr); //= trueWorks seamlessly!
IPCheck.match('FE80:0000:0000:0000:0202:B3FF:FE1E:8329', 'FE80:0000:0000:0000:0202:B3FF:FE1E:8329/128'); //= trueAs all IPv4 addresses are converted to IPv6, transitional IPs are supported.
var ip = new IPCheck('192.168.0.1'); var ipv4cidr = new IPCheck('192.168.0.1/32'); var ipv6cidr = new IPCheck('::ffff:192.168.0.1/128'); ip.match(ipv4cidr); //= true ip.match(ipv6cidr); //= trueTo convert a CIDR from IPv4 to IPv6, the mask simply has 96 added to it.
IPCheck is designed to not throw errors.
If you'd like to know an address is valid, simply read the valid property...
var ip = new IPCheck('192.168.0.1'); ip.valid; //= true var badIP = new IPCheck([ 'huh?' ]); badIP.valid; //= false var anotherBadIP = new IPCheck('silly.ip'); anotherBadIP.valid; //= false // Match always returns false if either the IP or the CIDR are invalid IPCheck.match('hi', 'oh/no');npm run benchmark - simply compares this to ipaddr.js and ip-address modules in places. The TL;DR of it is that ipcheck is reliably faster.
npm test - ensure everything works!