ip-bigint

    

> Convert IPv4 and IPv6 addresses to and from BigInt

Usage

``js
import {parseIp, stringifyIp, normalizeIp} from "ip-bigint";

const parsedIp = parseIp("2001:db8::");
// => {number: 42540766411282592856903984951653826560n, version: 6}

stringifyIp(parsedIp);
// => "2001:db8::"

normalizeIp("2001:db8::0:0:1");
// => "2001:db8::1"
`

API

$3

Parse a IP address string to a ParsedIp object.

For IPv4 returns {number, version}.
For IPv6 returns {number, version, [ipv4mapped], [scopeid]}.

There is only rudimentary validation that the passed string is actually an IP address. You are encouraged to validate yourself using modules like ip-regex.

$3

Convert a ParsedIp object back to an IP address string.

opts: Options StringifyOpts
- compress: boolean - Whether to compress the IP. For IPv6, this means the "best representation" all-lowercase shortest possible form. Default: true.
- hexify: boolean - Whether to convert IPv4-Mapped IPv6 addresses to hex. Default: false.

$3

Round-trip an IP address through parseIp and stringifyIp, effectively normalizing its representation.

opts: Options StringifyOpts
- compress: boolean - Whether to compress the IP. For IPv6, this means the "best representation" all-lowercase shortest possible form. Default: true.
- hexify: boolean - Whether to convert IPv4-Mapped IPv6 addresses to hex. Default: false.

$3

A bigint value that holds the biggest possible IPv4 address.

$3

A bigint` value that holds the biggest possible IPv6 address.

$3

Returns a integer of the IP version, 4, 6 or 0 if it's not an IP. Very rudimentary and should not be used for validation.

Related

- ip-regex - Regular expression for matching IP addresses
- is-cidr - Check if a string is an IP address in CIDR notation
- is-ip - Check if a string is an IP address
- cidr-regex - Check if a string is an IP address in CIDR notation
- cidr-tools - Tools to work with IPv4 and IPv6 CIDR network lists

License

© silverwind, distributed under BSD licence