cidr-tools

cidr-tools

Tools to work with IPv4 and IPv6 CIDR network lists

Install

$ npm i cidr-tools

Example

import {merge, exclude, expand, overlap, contains, normalize} from 'cidr-tools';

merge(['1.0.0.0/24', '1.0.1.0/24']); //=> ['1.0.0.0/23']
exclude(['::1/127'], ['::1/128']) //=> ['::/128']
expand(['2001:db8::/126']) //=> ['2001:db8::', '2001:db8::1', '2001:db8::2', '2001:db8::3']
overlap('1.0.0.0/24', '1.0.0.128/25') //=> true
contains(["1.0.0.0/24", "2.0.0.0/24"], "1.0.0.1") //=> true
normalize('::ffff/64') //=> '::/64'

API

All functions take CIDR addresses or single IP addresses. On single addresses, a prefix of /32 or /128 is assumed. Function that return networks will return a merged and sorted set of networks with IPv4 sorted before IPv6.

This module requires BigInt support in your environment.

merge(networks)

• networks String or Array: One or more CIDR or IP addresses.

Returns an array of merged networks.

exclude(baseNetworks, excludeNetworks)

• baseNetworks String or Array: One or more CIDR or IP addresses.
• excludeNetworks String or Array: One or more CIDR or IP addresses to exclude from baseNetworks.

Returns an array of merged remaining networks.

expand(networks)

• networks String or Array: One or more CIDR or IP addresses.

Returns an array of individual IPs contained in the networks.

overlap(networksA, networksB)

• networksA String or Array: One or more CIDR or IP address.
• networksB String or Array: One or more CIDR or IP address.

Returns a boolean that indicates if networksA overlap (intersect) with networksB.

contains(networksA, networksB)

• networksA String or Array: One or more CIDR or IP address.
• networksB String or Array: One or more CIDR or IP address.

Returns a boolean that indicates whether networksA fully contain all networksB.

normalize(networks, [opts])

• networks String or Array: One or more CIDR or IP address.

Returns a string or array (depending on input) with a normalized representation. Will not include a prefix on single IPs.

opts: Options Object

• compress: Whether to compress the IP. For IPv6, this means the "best representation" all-lowercase shortest possible form. Default: true.

© silverwind, distributed under BSD licence.