1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000 |
- (function (root) {
- 'use strict';
- // A list of regular expressions that match arbitrary IPv4 addresses,
- // for which a number of weird notations exist.
- // Note that an address like 0010.0xa5.1.1 is considered legal.
- const ipv4Part = '(0?\\d+|0x[a-f0-9]+)';
- const ipv4Regexes = {
- fourOctet: new RegExp(`^${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}$`, 'i'),
- threeOctet: new RegExp(`^${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}$`, 'i'),
- twoOctet: new RegExp(`^${ipv4Part}\\.${ipv4Part}$`, 'i'),
- longValue: new RegExp(`^${ipv4Part}$`, 'i')
- };
- // Regular Expression for checking Octal numbers
- const octalRegex = new RegExp(`^0[0-7]+$`, 'i');
- const hexRegex = new RegExp(`^0x[a-f0-9]+$`, 'i');
- const zoneIndex = '%[0-9a-z]{1,}';
- // IPv6-matching regular expressions.
- // For IPv6, the task is simpler: it is enough to match the colon-delimited
- // hexadecimal IPv6 and a transitional variant with dotted-decimal IPv4 at
- // the end.
- const ipv6Part = '(?:[0-9a-f]+::?)+';
- const ipv6Regexes = {
- zoneIndex: new RegExp(zoneIndex, 'i'),
- 'native': new RegExp(`^(::)?(${ipv6Part})?([0-9a-f]+)?(::)?(${zoneIndex})?$`, 'i'),
- deprecatedTransitional: new RegExp(`^(?:::)(${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}(${zoneIndex})?)$`, 'i'),
- transitional: new RegExp(`^((?:${ipv6Part})|(?:::)(?:${ipv6Part})?)${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}\\.${ipv4Part}(${zoneIndex})?$`, 'i')
- };
- // Expand :: in an IPv6 address or address part consisting of `parts` groups.
- function expandIPv6 (string, parts) {
- // More than one '::' means invalid adddress
- if (string.indexOf('::') !== string.lastIndexOf('::')) {
- return null;
- }
- let colonCount = 0;
- let lastColon = -1;
- let zoneId = (string.match(ipv6Regexes.zoneIndex) || [])[0];
- let replacement, replacementCount;
- // Remove zone index and save it for later
- if (zoneId) {
- zoneId = zoneId.substring(1);
- string = string.replace(/%.+$/, '');
- }
- // How many parts do we already have?
- while ((lastColon = string.indexOf(':', lastColon + 1)) >= 0) {
- colonCount++;
- }
- // 0::0 is two parts more than ::
- if (string.substr(0, 2) === '::') {
- colonCount--;
- }
- if (string.substr(-2, 2) === '::') {
- colonCount--;
- }
- // The following loop would hang if colonCount > parts
- if (colonCount > parts) {
- return null;
- }
- // replacement = ':' + '0:' * (parts - colonCount)
- replacementCount = parts - colonCount;
- replacement = ':';
- while (replacementCount--) {
- replacement += '0:';
- }
- // Insert the missing zeroes
- string = string.replace('::', replacement);
- // Trim any garbage which may be hanging around if :: was at the edge in
- // the source strin
- if (string[0] === ':') {
- string = string.slice(1);
- }
- if (string[string.length - 1] === ':') {
- string = string.slice(0, -1);
- }
- parts = (function () {
- const ref = string.split(':');
- const results = [];
- for (let i = 0; i < ref.length; i++) {
- results.push(parseInt(ref[i], 16));
- }
- return results;
- })();
- return {
- parts: parts,
- zoneId: zoneId
- };
- }
- // A generic CIDR (Classless Inter-Domain Routing) RFC1518 range matcher.
- function matchCIDR (first, second, partSize, cidrBits) {
- if (first.length !== second.length) {
- throw new Error('ipaddr: cannot match CIDR for objects with different lengths');
- }
- let part = 0;
- let shift;
- while (cidrBits > 0) {
- shift = partSize - cidrBits;
- if (shift < 0) {
- shift = 0;
- }
- if (first[part] >> shift !== second[part] >> shift) {
- return false;
- }
- cidrBits -= partSize;
- part += 1;
- }
- return true;
- }
- function parseIntAuto (string) {
- // Hexadedimal base 16 (0x#)
- if (hexRegex.test(string)) {
- return parseInt(string, 16);
- }
- // While octal representation is discouraged by ECMAScript 3
- // and forbidden by ECMAScript 5, we silently allow it to
- // work only if the rest of the string has numbers less than 8.
- if (string[0] === '0' && !isNaN(parseInt(string[1], 10))) {
- if (octalRegex.test(string)) {
- return parseInt(string, 8);
- }
- throw new Error(`ipaddr: cannot parse ${string} as octal`);
- }
- // Always include the base 10 radix!
- return parseInt(string, 10);
- }
- function padPart (part, length) {
- while (part.length < length) {
- part = `0${part}`;
- }
- return part;
- }
- const ipaddr = {};
- // An IPv4 address (RFC791).
- ipaddr.IPv4 = (function () {
- // Constructs a new IPv4 address from an array of four octets
- // in network order (MSB first)
- // Verifies the input.
- function IPv4 (octets) {
- if (octets.length !== 4) {
- throw new Error('ipaddr: ipv4 octet count should be 4');
- }
- let i, octet;
- for (i = 0; i < octets.length; i++) {
- octet = octets[i];
- if (!((0 <= octet && octet <= 255))) {
- throw new Error('ipaddr: ipv4 octet should fit in 8 bits');
- }
- }
- this.octets = octets;
- }
- // Special IPv4 address ranges.
- // See also https://en.wikipedia.org/wiki/Reserved_IP_addresses
- IPv4.prototype.SpecialRanges = {
- unspecified: [[new IPv4([0, 0, 0, 0]), 8]],
- broadcast: [[new IPv4([255, 255, 255, 255]), 32]],
- // RFC3171
- multicast: [[new IPv4([224, 0, 0, 0]), 4]],
- // RFC3927
- linkLocal: [[new IPv4([169, 254, 0, 0]), 16]],
- // RFC5735
- loopback: [[new IPv4([127, 0, 0, 0]), 8]],
- // RFC6598
- carrierGradeNat: [[new IPv4([100, 64, 0, 0]), 10]],
- // RFC1918
- 'private': [
- [new IPv4([10, 0, 0, 0]), 8],
- [new IPv4([172, 16, 0, 0]), 12],
- [new IPv4([192, 168, 0, 0]), 16]
- ],
- // Reserved and testing-only ranges; RFCs 5735, 5737, 2544, 1700
- reserved: [
- [new IPv4([192, 0, 0, 0]), 24],
- [new IPv4([192, 0, 2, 0]), 24],
- [new IPv4([192, 88, 99, 0]), 24],
- [new IPv4([198, 18, 0, 0]), 15],
- [new IPv4([198, 51, 100, 0]), 24],
- [new IPv4([203, 0, 113, 0]), 24],
- [new IPv4([240, 0, 0, 0]), 4]
- ]
- };
- // The 'kind' method exists on both IPv4 and IPv6 classes.
- IPv4.prototype.kind = function () {
- return 'ipv4';
- };
- // Checks if this address matches other one within given CIDR range.
- IPv4.prototype.match = function (other, cidrRange) {
- let ref;
- if (cidrRange === undefined) {
- ref = other;
- other = ref[0];
- cidrRange = ref[1];
- }
- if (other.kind() !== 'ipv4') {
- throw new Error('ipaddr: cannot match ipv4 address with non-ipv4 one');
- }
- return matchCIDR(this.octets, other.octets, 8, cidrRange);
- };
- // returns a number of leading ones in IPv4 address, making sure that
- // the rest is a solid sequence of 0's (valid netmask)
- // returns either the CIDR length or null if mask is not valid
- IPv4.prototype.prefixLengthFromSubnetMask = function () {
- let cidr = 0;
- // non-zero encountered stop scanning for zeroes
- let stop = false;
- // number of zeroes in octet
- const zerotable = {
- 0: 8,
- 128: 7,
- 192: 6,
- 224: 5,
- 240: 4,
- 248: 3,
- 252: 2,
- 254: 1,
- 255: 0
- };
- let i, octet, zeros;
- for (i = 3; i >= 0; i -= 1) {
- octet = this.octets[i];
- if (octet in zerotable) {
- zeros = zerotable[octet];
- if (stop && zeros !== 0) {
- return null;
- }
- if (zeros !== 8) {
- stop = true;
- }
- cidr += zeros;
- } else {
- return null;
- }
- }
- return 32 - cidr;
- };
- // Checks if the address corresponds to one of the special ranges.
- IPv4.prototype.range = function () {
- return ipaddr.subnetMatch(this, this.SpecialRanges);
- };
- // Returns an array of byte-sized values in network order (MSB first)
- IPv4.prototype.toByteArray = function () {
- return this.octets.slice(0);
- };
- // Converts this IPv4 address to an IPv4-mapped IPv6 address.
- IPv4.prototype.toIPv4MappedAddress = function () {
- return ipaddr.IPv6.parse(`::ffff:${this.toString()}`);
- };
- // Symmetrical method strictly for aligning with the IPv6 methods.
- IPv4.prototype.toNormalizedString = function () {
- return this.toString();
- };
- // Returns the address in convenient, decimal-dotted format.
- IPv4.prototype.toString = function () {
- return this.octets.join('.');
- };
- return IPv4;
- })();
- // A utility function to return broadcast address given the IPv4 interface and prefix length in CIDR notation
- ipaddr.IPv4.broadcastAddressFromCIDR = function (string) {
- try {
- const cidr = this.parseCIDR(string);
- const ipInterfaceOctets = cidr[0].toByteArray();
- const subnetMaskOctets = this.subnetMaskFromPrefixLength(cidr[1]).toByteArray();
- const octets = [];
- let i = 0;
- while (i < 4) {
- // Broadcast address is bitwise OR between ip interface and inverted mask
- octets.push(parseInt(ipInterfaceOctets[i], 10) | parseInt(subnetMaskOctets[i], 10) ^ 255);
- i++;
- }
- return new this(octets);
- } catch (e) {
- throw new Error('ipaddr: the address does not have IPv4 CIDR format');
- }
- };
- // Checks if a given string is formatted like IPv4 address.
- ipaddr.IPv4.isIPv4 = function (string) {
- return this.parser(string) !== null;
- };
- // Checks if a given string is a valid IPv4 address.
- ipaddr.IPv4.isValid = function (string) {
- try {
- new this(this.parser(string));
- return true;
- } catch (e) {
- return false;
- }
- };
- // Checks if a given string is a full four-part IPv4 Address.
- ipaddr.IPv4.isValidFourPartDecimal = function (string) {
- if (ipaddr.IPv4.isValid(string) && string.match(/^(0|[1-9]\d*)(\.(0|[1-9]\d*)){3}$/)) {
- return true;
- } else {
- return false;
- }
- };
- // A utility function to return network address given the IPv4 interface and prefix length in CIDR notation
- ipaddr.IPv4.networkAddressFromCIDR = function (string) {
- let cidr, i, ipInterfaceOctets, octets, subnetMaskOctets;
- try {
- cidr = this.parseCIDR(string);
- ipInterfaceOctets = cidr[0].toByteArray();
- subnetMaskOctets = this.subnetMaskFromPrefixLength(cidr[1]).toByteArray();
- octets = [];
- i = 0;
- while (i < 4) {
- // Network address is bitwise AND between ip interface and mask
- octets.push(parseInt(ipInterfaceOctets[i], 10) & parseInt(subnetMaskOctets[i], 10));
- i++;
- }
- return new this(octets);
- } catch (e) {
- throw new Error('ipaddr: the address does not have IPv4 CIDR format');
- }
- };
- // Tries to parse and validate a string with IPv4 address.
- // Throws an error if it fails.
- ipaddr.IPv4.parse = function (string) {
- const parts = this.parser(string);
- if (parts === null) {
- throw new Error('ipaddr: string is not formatted like an IPv4 Address');
- }
- return new this(parts);
- };
- // Parses the string as an IPv4 Address with CIDR Notation.
- ipaddr.IPv4.parseCIDR = function (string) {
- let match;
- if ((match = string.match(/^(.+)\/(\d+)$/))) {
- const maskLength = parseInt(match[2]);
- if (maskLength >= 0 && maskLength <= 32) {
- const parsed = [this.parse(match[1]), maskLength];
- Object.defineProperty(parsed, 'toString', {
- value: function () {
- return this.join('/');
- }
- });
- return parsed;
- }
- }
- throw new Error('ipaddr: string is not formatted like an IPv4 CIDR range');
- };
- // Classful variants (like a.b, where a is an octet, and b is a 24-bit
- // value representing last three octets; this corresponds to a class C
- // address) are omitted due to classless nature of modern Internet.
- ipaddr.IPv4.parser = function (string) {
- let match, part, value;
- // parseInt recognizes all that octal & hexadecimal weirdness for us
- if ((match = string.match(ipv4Regexes.fourOctet))) {
- return (function () {
- const ref = match.slice(1, 6);
- const results = [];
- for (let i = 0; i < ref.length; i++) {
- part = ref[i];
- results.push(parseIntAuto(part));
- }
- return results;
- })();
- } else if ((match = string.match(ipv4Regexes.longValue))) {
- value = parseIntAuto(match[1]);
- if (value > 0xffffffff || value < 0) {
- throw new Error('ipaddr: address outside defined range');
- }
- return ((function () {
- const results = [];
- let shift;
- for (shift = 0; shift <= 24; shift += 8) {
- results.push((value >> shift) & 0xff);
- }
- return results;
- })()).reverse();
- } else if ((match = string.match(ipv4Regexes.twoOctet))) {
- return (function () {
- const ref = match.slice(1, 4);
- const results = [];
- value = parseIntAuto(ref[1]);
- if (value > 0xffffff || value < 0) {
- throw new Error('ipaddr: address outside defined range');
- }
- results.push(parseIntAuto(ref[0]));
- results.push((value >> 16) & 0xff);
- results.push((value >> 8) & 0xff);
- results.push( value & 0xff);
- return results;
- })();
- } else if ((match = string.match(ipv4Regexes.threeOctet))) {
- return (function () {
- const ref = match.slice(1, 5);
- const results = [];
- value = parseIntAuto(ref[2]);
- if (value > 0xffff || value < 0) {
- throw new Error('ipaddr: address outside defined range');
- }
- results.push(parseIntAuto(ref[0]));
- results.push(parseIntAuto(ref[1]));
- results.push((value >> 8) & 0xff);
- results.push( value & 0xff);
- return results;
- })();
- } else {
- return null;
- }
- };
- // A utility function to return subnet mask in IPv4 format given the prefix length
- ipaddr.IPv4.subnetMaskFromPrefixLength = function (prefix) {
- prefix = parseInt(prefix);
- if (prefix < 0 || prefix > 32) {
- throw new Error('ipaddr: invalid IPv4 prefix length');
- }
- const octets = [0, 0, 0, 0];
- let j = 0;
- const filledOctetCount = Math.floor(prefix / 8);
- while (j < filledOctetCount) {
- octets[j] = 255;
- j++;
- }
- if (filledOctetCount < 4) {
- octets[filledOctetCount] = Math.pow(2, prefix % 8) - 1 << 8 - (prefix % 8);
- }
- return new this(octets);
- };
- // An IPv6 address (RFC2460)
- ipaddr.IPv6 = (function () {
- // Constructs an IPv6 address from an array of eight 16 - bit parts
- // or sixteen 8 - bit parts in network order(MSB first).
- // Throws an error if the input is invalid.
- function IPv6 (parts, zoneId) {
- let i, part;
- if (parts.length === 16) {
- this.parts = [];
- for (i = 0; i <= 14; i += 2) {
- this.parts.push((parts[i] << 8) | parts[i + 1]);
- }
- } else if (parts.length === 8) {
- this.parts = parts;
- } else {
- throw new Error('ipaddr: ipv6 part count should be 8 or 16');
- }
- for (i = 0; i < this.parts.length; i++) {
- part = this.parts[i];
- if (!((0 <= part && part <= 0xffff))) {
- throw new Error('ipaddr: ipv6 part should fit in 16 bits');
- }
- }
- if (zoneId) {
- this.zoneId = zoneId;
- }
- }
- // Special IPv6 ranges
- IPv6.prototype.SpecialRanges = {
- // RFC4291, here and after
- unspecified: [new IPv6([0, 0, 0, 0, 0, 0, 0, 0]), 128],
- linkLocal: [new IPv6([0xfe80, 0, 0, 0, 0, 0, 0, 0]), 10],
- multicast: [new IPv6([0xff00, 0, 0, 0, 0, 0, 0, 0]), 8],
- loopback: [new IPv6([0, 0, 0, 0, 0, 0, 0, 1]), 128],
- uniqueLocal: [new IPv6([0xfc00, 0, 0, 0, 0, 0, 0, 0]), 7],
- ipv4Mapped: [new IPv6([0, 0, 0, 0, 0, 0xffff, 0, 0]), 96],
- // RFC6145
- rfc6145: [new IPv6([0, 0, 0, 0, 0xffff, 0, 0, 0]), 96],
- // RFC6052
- rfc6052: [new IPv6([0x64, 0xff9b, 0, 0, 0, 0, 0, 0]), 96],
- // RFC3056
- '6to4': [new IPv6([0x2002, 0, 0, 0, 0, 0, 0, 0]), 16],
- // RFC6052, RFC6146
- teredo: [new IPv6([0x2001, 0, 0, 0, 0, 0, 0, 0]), 32],
- // RFC4291
- reserved: [[new IPv6([0x2001, 0xdb8, 0, 0, 0, 0, 0, 0]), 32]],
- benchmarking: [new IPv6([0x2001, 0x2, 0, 0, 0, 0, 0, 0]), 48],
- amt: [new IPv6([0x2001, 0x3, 0, 0, 0, 0, 0, 0]), 32],
- as112v6: [new IPv6([0x2001, 0x4, 0x112, 0, 0, 0, 0, 0]), 48],
- deprecated: [new IPv6([0x2001, 0x10, 0, 0, 0, 0, 0, 0]), 28],
- orchid2: [new IPv6([0x2001, 0x20, 0, 0, 0, 0, 0, 0]), 28]
- };
- // Checks if this address is an IPv4-mapped IPv6 address.
- IPv6.prototype.isIPv4MappedAddress = function () {
- return this.range() === 'ipv4Mapped';
- };
- // The 'kind' method exists on both IPv4 and IPv6 classes.
- IPv6.prototype.kind = function () {
- return 'ipv6';
- };
- // Checks if this address matches other one within given CIDR range.
- IPv6.prototype.match = function (other, cidrRange) {
- let ref;
- if (cidrRange === undefined) {
- ref = other;
- other = ref[0];
- cidrRange = ref[1];
- }
- if (other.kind() !== 'ipv6') {
- throw new Error('ipaddr: cannot match ipv6 address with non-ipv6 one');
- }
- return matchCIDR(this.parts, other.parts, 16, cidrRange);
- };
- // returns a number of leading ones in IPv6 address, making sure that
- // the rest is a solid sequence of 0's (valid netmask)
- // returns either the CIDR length or null if mask is not valid
- IPv6.prototype.prefixLengthFromSubnetMask = function () {
- let cidr = 0;
- // non-zero encountered stop scanning for zeroes
- let stop = false;
- // number of zeroes in octet
- const zerotable = {
- 0: 16,
- 32768: 15,
- 49152: 14,
- 57344: 13,
- 61440: 12,
- 63488: 11,
- 64512: 10,
- 65024: 9,
- 65280: 8,
- 65408: 7,
- 65472: 6,
- 65504: 5,
- 65520: 4,
- 65528: 3,
- 65532: 2,
- 65534: 1,
- 65535: 0
- };
- let part, zeros;
- for (let i = 7; i >= 0; i -= 1) {
- part = this.parts[i];
- if (part in zerotable) {
- zeros = zerotable[part];
- if (stop && zeros !== 0) {
- return null;
- }
- if (zeros !== 16) {
- stop = true;
- }
- cidr += zeros;
- } else {
- return null;
- }
- }
- return 128 - cidr;
- };
- // Checks if the address corresponds to one of the special ranges.
- IPv6.prototype.range = function () {
- return ipaddr.subnetMatch(this, this.SpecialRanges);
- };
- // Returns an array of byte-sized values in network order (MSB first)
- IPv6.prototype.toByteArray = function () {
- let part;
- const bytes = [];
- const ref = this.parts;
- for (let i = 0; i < ref.length; i++) {
- part = ref[i];
- bytes.push(part >> 8);
- bytes.push(part & 0xff);
- }
- return bytes;
- };
- // Returns the address in expanded format with all zeroes included, like
- // 2001:0db8:0008:0066:0000:0000:0000:0001
- IPv6.prototype.toFixedLengthString = function () {
- const addr = ((function () {
- const results = [];
- for (let i = 0; i < this.parts.length; i++) {
- results.push(padPart(this.parts[i].toString(16), 4));
- }
- return results;
- }).call(this)).join(':');
- let suffix = '';
- if (this.zoneId) {
- suffix = `%${this.zoneId}`;
- }
- return addr + suffix;
- };
- // Converts this address to IPv4 address if it is an IPv4-mapped IPv6 address.
- // Throws an error otherwise.
- IPv6.prototype.toIPv4Address = function () {
- if (!this.isIPv4MappedAddress()) {
- throw new Error('ipaddr: trying to convert a generic ipv6 address to ipv4');
- }
- const ref = this.parts.slice(-2);
- const high = ref[0];
- const low = ref[1];
- return new ipaddr.IPv4([high >> 8, high & 0xff, low >> 8, low & 0xff]);
- };
- // Returns the address in expanded format with all zeroes included, like
- // 2001:db8:8:66:0:0:0:1
- //
- // Deprecated: use toFixedLengthString() instead.
- IPv6.prototype.toNormalizedString = function () {
- const addr = ((function () {
- const results = [];
- for (let i = 0; i < this.parts.length; i++) {
- results.push(this.parts[i].toString(16));
- }
- return results;
- }).call(this)).join(':');
- let suffix = '';
- if (this.zoneId) {
- suffix = `%${this.zoneId}`;
- }
- return addr + suffix;
- };
- // Returns the address in compact, human-readable format like
- // 2001:db8:8:66::1
- // in line with RFC 5952 (see https://tools.ietf.org/html/rfc5952#section-4)
- IPv6.prototype.toRFC5952String = function () {
- const regex = /((^|:)(0(:|$)){2,})/g;
- const string = this.toNormalizedString();
- let bestMatchIndex = 0;
- let bestMatchLength = -1;
- let match;
- while ((match = regex.exec(string))) {
- if (match[0].length > bestMatchLength) {
- bestMatchIndex = match.index;
- bestMatchLength = match[0].length;
- }
- }
- if (bestMatchLength < 0) {
- return string;
- }
- return `${string.substring(0, bestMatchIndex)}::${string.substring(bestMatchIndex + bestMatchLength)}`;
- };
- // Returns the address in compact, human-readable format like
- // 2001:db8:8:66::1
- // Calls toRFC5952String under the hood.
- IPv6.prototype.toString = function () {
- return this.toRFC5952String();
- };
- return IPv6;
- })();
- // A utility function to return broadcast address given the IPv6 interface and prefix length in CIDR notation
- ipaddr.IPv6.broadcastAddressFromCIDR = function (string) {
- try {
- const cidr = this.parseCIDR(string);
- const ipInterfaceOctets = cidr[0].toByteArray();
- const subnetMaskOctets = this.subnetMaskFromPrefixLength(cidr[1]).toByteArray();
- const octets = [];
- let i = 0;
- while (i < 16) {
- // Broadcast address is bitwise OR between ip interface and inverted mask
- octets.push(parseInt(ipInterfaceOctets[i], 10) | parseInt(subnetMaskOctets[i], 10) ^ 255);
- i++;
- }
- return new this(octets);
- } catch (e) {
- throw new Error(`ipaddr: the address does not have IPv6 CIDR format (${e})`);
- }
- };
- // Checks if a given string is formatted like IPv6 address.
- ipaddr.IPv6.isIPv6 = function (string) {
- return this.parser(string) !== null;
- };
- // Checks to see if string is a valid IPv6 Address
- ipaddr.IPv6.isValid = function (string) {
- // Since IPv6.isValid is always called first, this shortcut
- // provides a substantial performance gain.
- if (typeof string === 'string' && string.indexOf(':') === -1) {
- return false;
- }
- try {
- const addr = this.parser(string);
- new this(addr.parts, addr.zoneId);
- return true;
- } catch (e) {
- return false;
- }
- };
- // A utility function to return network address given the IPv6 interface and prefix length in CIDR notation
- ipaddr.IPv6.networkAddressFromCIDR = function (string) {
- let cidr, i, ipInterfaceOctets, octets, subnetMaskOctets;
- try {
- cidr = this.parseCIDR(string);
- ipInterfaceOctets = cidr[0].toByteArray();
- subnetMaskOctets = this.subnetMaskFromPrefixLength(cidr[1]).toByteArray();
- octets = [];
- i = 0;
- while (i < 16) {
- // Network address is bitwise AND between ip interface and mask
- octets.push(parseInt(ipInterfaceOctets[i], 10) & parseInt(subnetMaskOctets[i], 10));
- i++;
- }
- return new this(octets);
- } catch (e) {
- throw new Error(`ipaddr: the address does not have IPv6 CIDR format (${e})`);
- }
- };
- // Tries to parse and validate a string with IPv6 address.
- // Throws an error if it fails.
- ipaddr.IPv6.parse = function (string) {
- const addr = this.parser(string);
- if (addr.parts === null) {
- throw new Error('ipaddr: string is not formatted like an IPv6 Address');
- }
- return new this(addr.parts, addr.zoneId);
- };
- ipaddr.IPv6.parseCIDR = function (string) {
- let maskLength, match, parsed;
- if ((match = string.match(/^(.+)\/(\d+)$/))) {
- maskLength = parseInt(match[2]);
- if (maskLength >= 0 && maskLength <= 128) {
- parsed = [this.parse(match[1]), maskLength];
- Object.defineProperty(parsed, 'toString', {
- value: function () {
- return this.join('/');
- }
- });
- return parsed;
- }
- }
- throw new Error('ipaddr: string is not formatted like an IPv6 CIDR range');
- };
- // Parse an IPv6 address.
- ipaddr.IPv6.parser = function (string) {
- let addr, i, match, octet, octets, zoneId;
- if ((match = string.match(ipv6Regexes.deprecatedTransitional))) {
- return this.parser(`::ffff:${match[1]}`);
- }
- if (ipv6Regexes.native.test(string)) {
- return expandIPv6(string, 8);
- }
- if ((match = string.match(ipv6Regexes.transitional))) {
- zoneId = match[6] || '';
- addr = expandIPv6(match[1].slice(0, -1) + zoneId, 6);
- if (addr.parts) {
- octets = [
- parseInt(match[2]),
- parseInt(match[3]),
- parseInt(match[4]),
- parseInt(match[5])
- ];
- for (i = 0; i < octets.length; i++) {
- octet = octets[i];
- if (!((0 <= octet && octet <= 255))) {
- return null;
- }
- }
- addr.parts.push(octets[0] << 8 | octets[1]);
- addr.parts.push(octets[2] << 8 | octets[3]);
- return {
- parts: addr.parts,
- zoneId: addr.zoneId
- };
- }
- }
- return null;
- };
- // A utility function to return subnet mask in IPv6 format given the prefix length
- ipaddr.IPv6.subnetMaskFromPrefixLength = function (prefix) {
- prefix = parseInt(prefix);
- if (prefix < 0 || prefix > 128) {
- throw new Error('ipaddr: invalid IPv6 prefix length');
- }
- const octets = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0];
- let j = 0;
- const filledOctetCount = Math.floor(prefix / 8);
- while (j < filledOctetCount) {
- octets[j] = 255;
- j++;
- }
- if (filledOctetCount < 16) {
- octets[filledOctetCount] = Math.pow(2, prefix % 8) - 1 << 8 - (prefix % 8);
- }
- return new this(octets);
- };
- // Try to parse an array in network order (MSB first) for IPv4 and IPv6
- ipaddr.fromByteArray = function (bytes) {
- const length = bytes.length;
- if (length === 4) {
- return new ipaddr.IPv4(bytes);
- } else if (length === 16) {
- return new ipaddr.IPv6(bytes);
- } else {
- throw new Error('ipaddr: the binary input is neither an IPv6 nor IPv4 address');
- }
- };
- // Checks if the address is valid IP address
- ipaddr.isValid = function (string) {
- return ipaddr.IPv6.isValid(string) || ipaddr.IPv4.isValid(string);
- };
- // Attempts to parse an IP Address, first through IPv6 then IPv4.
- // Throws an error if it could not be parsed.
- ipaddr.parse = function (string) {
- if (ipaddr.IPv6.isValid(string)) {
- return ipaddr.IPv6.parse(string);
- } else if (ipaddr.IPv4.isValid(string)) {
- return ipaddr.IPv4.parse(string);
- } else {
- throw new Error('ipaddr: the address has neither IPv6 nor IPv4 format');
- }
- };
- // Attempt to parse CIDR notation, first through IPv6 then IPv4.
- // Throws an error if it could not be parsed.
- ipaddr.parseCIDR = function (string) {
- try {
- return ipaddr.IPv6.parseCIDR(string);
- } catch (e) {
- try {
- return ipaddr.IPv4.parseCIDR(string);
- } catch (e2) {
- throw new Error('ipaddr: the address has neither IPv6 nor IPv4 CIDR format');
- }
- }
- };
- // Parse an address and return plain IPv4 address if it is an IPv4-mapped address
- ipaddr.process = function (string) {
- const addr = this.parse(string);
- if (addr.kind() === 'ipv6' && addr.isIPv4MappedAddress()) {
- return addr.toIPv4Address();
- } else {
- return addr;
- }
- };
- // An utility function to ease named range matching. See examples below.
- // rangeList can contain both IPv4 and IPv6 subnet entries and will not throw errors
- // on matching IPv4 addresses to IPv6 ranges or vice versa.
- ipaddr.subnetMatch = function (address, rangeList, defaultName) {
- let i, rangeName, rangeSubnets, subnet;
- if (defaultName === undefined || defaultName === null) {
- defaultName = 'unicast';
- }
- for (rangeName in rangeList) {
- if (Object.prototype.hasOwnProperty.call(rangeList, rangeName)) {
- rangeSubnets = rangeList[rangeName];
- // ECMA5 Array.isArray isn't available everywhere
- if (rangeSubnets[0] && !(rangeSubnets[0] instanceof Array)) {
- rangeSubnets = [rangeSubnets];
- }
- for (i = 0; i < rangeSubnets.length; i++) {
- subnet = rangeSubnets[i];
- if (address.kind() === subnet[0].kind() && address.match.apply(address, subnet)) {
- return rangeName;
- }
- }
- }
- }
- return defaultName;
- };
- // Export for both the CommonJS and browser-like environment
- if (typeof module !== 'undefined' && module.exports) {
- module.exports = ipaddr;
- } else {
- root.ipaddr = ipaddr;
- }
- }(this));
|