The IP Calculator is a powerful TypeScript library that simplifies the process of calculating various network details based on a given IP address and subnet mask. It offers a wide range of methods to set and validate the IP address and subnet mask, and calculate important network properties such as the network address, broadcast address, wildcard mask, first and last IP addresses, IPv4 class, number of hosts and networks, and the netmask in dot-decimal notation.
To use ip-calculator in your project, you need to install it through npm (Node Package Manager). Follow these steps:
npm install ip-calculator
or using yarn
yarn add ip-calculator
To get started with the IP Calculator, follow these simple steps:
- Import the
Calculator
class:
import { Calculator } from './calculator';
- Create a new instance of the class by passing in an object with the
ip
andmask
properties:
const calc = new Calculator({ ip: '192.168.1.1', mask: 24 });
Alternatively, you can use the setIp
and setMask
methods to set the IP address and subnet mask:
const calc = new Calculator()
.setIp('192.168.1.1')
.setMask(24);
- Call the
calculate
method to calculate the network details:
calc.calculate();
- Access the calculated values through the following properties:
ip
: the IP address in dot-decimal notationnetwork
: the network address in dot-decimal notationipv4Class
: the IPv4 class (A, B, C, D, or E)maxHosts
: the maximum number of hosts in the networkmaxNetworks
: the maximum number of networkswildcard
: the wildcard mask in dot-decimal notationhostMin
: the first IP address in the networkhostMax
: the last IP address in the networknetmask
: the netmask in dot-decimal notationbroadcast
: the broadcast address in dot-decimal notationmask
: the subnet mask in dot-decimal notation
Here's an example of how to use the IP Calculator to calculate the network details for the IP address 192.168.1.1
with a subnet mask of 24
:
import { Calculator } from './calculator';
const calc = new Calculator({ ip: '192.168.1.1', mask: '255.255.127.0' });
calc.calculate();
console.log(calc.ip); // 192.168.1.1
console.log(calc.network); // 192.168.1.0
console.log(calc.ipv4Class); // C
console.log(calc.maxHosts); // 254
console.log(calc.maxNetworks); // 1
console.log(calc.wildcard); // 0.0.0.255
console.log(calc.hostMin); // 192.168.1.1
console.log(calc.hostMax); // 192.168.1.254
console.log(calc.netmask); // 255.255.255.0
console.log(calc.broadcast); // 192.168.1.255
console.log(calc.mask); // 24
The Calculator
class can be instantiated with an optional options
parameter, which is an object that can contain the following properties:
-
ip
: A string representing the IP address to be used for the calculator. The string should be in the standard dot-decimal notation (e.g. "192.168.1.1"). This property is optional, and if it is not provided, an empty string will be used as the default value -
mask
: A number or string representing the subnet mask to be used for the calculator. If the mask is a number, it should be the number of bits in the mask (e.g. 24 for a Class C network). If the mask is a string, it should be in the standard dot-decimal notation (e.g. "255.255.255.0"). This property is optional, and if it is not provided, 0 will be used as the default value.
You can also use the setIp
and setMask
methods to set the IP address and subnet mask respectively, after instantiating the class. These methods take a single argument, which is a string representing the IP address or subnet mask in the standard dot-decimal notation.
The calculate
method of the class does not take any parameters, it uses the ip and mask set by the constructor or the setter methods to calculate the network details.
All these methods are chainable, meaning that you can call multiple methods on the same instance of the class in a single statement, like this:
import Calculator from './calculator';
console.log(
Calculator()
.setIp('10.0.0.1')
.setMask(24)
.calculate()
)
// Logs the following:
Calculator {
_ipOctets: [ 192, 168, 1, 1 ],
_maskBits: 24,
ip: '192.168.1.1',
network: '192.168.1.0',
netmask: '255.255.255.0',
broadcast: '192.168.1.255',
wildcard: '0.0.0.255',
hostMin: '192.168.1.1',
hostMax: '192.168.1.254',
ipv4Class: 'C',
maxHosts: '254',
maxNetworks: '16777216',
mask: '24'
}
This is known as the builder pattern.
The Calculator
class also includes two helper methods to convert IP addresses to binary or hexadecimal notation:
convertToBinary(ip: string): string
: converts an IP address in dot-decimal notation to binary notation.convertToHexa(ip: string): string
: converts an IP address in dot-decimal notation to hexadecimal notation.
import { Calculator } from './calculator';
const calc = new Calculator({ ip: '192.168.1.1', mask: '255.255.127.0' });
calc.calculate();
console.log(calc.convertToBinary(calc.ip)); // 11000000.10101000.00000001.00000001
console.log(calc.convertToHexa(calc.ip)); // c0a80101
First of all, you need to build the project. You can do that by running the following commands:
npm run build
npm run build:examples
You can choose the example you want to use by using the --file
flag. For example, if you want to use the cli-example1
example, you can run the following command:
npm run example --file=cli-example1 --ip='192.168.1.1' --mask='24'
where --file
is the name of the example you want to use, --ip
is the IP address you want to use, and --mask
is the subnet mask you want to use. Remember --mask
could be in dot-decimal notation or number.
The output will be:
IP: 192.168.1.1
Network: 192.168.1.0
Netmask: 255.255.255.0
Broadcast: 192.168.1.255
Wildcard: 0.0.0.255
HostMin: 192.168.1.1
HostMax: 192.168.1.254
IPv4 Class: C
Max Hosts: 254
Max Networks: 16777216
Or using the cli-example2
example:
npm run example --file=cli-example2 --ip='10.0.0.129' --mask=16
// Logs the following:
Calculator {
_ipOctets: [ 10, 0, 0, 129 ],
_maskBits: 16,
ip: '10.0.0.129',
network: '10.0.0.0',
netmask: '255.255.0.0',
broadcast: '10.0.255.255',
wildcard: '0.0.255.255',
hostMin: '10.0.0.1',
hostMax: '10.0.255.254',
ipv4Class: 'A',
maxHosts: '65534',
maxNetworks: '65536',
mask: '16'
}
There are a test suite in test/calculator.test.ts
to test the constructor
, setIp
, setMask
, calculate
, convertToHexa
, convertToBinary
methods. You can run it by executing the following command:
npm run pretest
npm run test