classifyv4.ts - @hertzg/ip documentation

IPv4 address classification utilities.

This module provides functions to classify IPv4 addresses into well-known ranges defined by IANA and various RFCs. Each function checks if an IPv4 address (as a 32-bit unsigned integer) belongs to a specific range.

Examples

Classify an IPv4 address

import { assertEquals } from "@std/assert";
import { classifyAddressv4 } from "@hertzg/ip/classifyv4";
import { parseAddressv4 } from "@hertzg/ip/addressv4";

assertEquals(classifyAddressv4(parseAddressv4("192.168.1.1").address), "private");
assertEquals(classifyAddressv4(parseAddressv4("8.8.8.8").address), "public");
assertEquals(classifyAddressv4(parseAddressv4("127.0.0.1").address), "loopback");
assertEquals(classifyAddressv4(parseAddressv4("224.0.0.1").address), "multicast");

Check specific ranges

import { assert, assertEquals } from "@std/assert";
import { isAddressv4Loopback, isAddressv4Private, isAddressv4Public } from "@hertzg/ip/classifyv4";
import { parseAddressv4 } from "@hertzg/ip/addressv4";

assert(isAddressv4Loopback(parseAddressv4("127.0.0.1").address));
assert(isAddressv4Private(parseAddressv4("10.0.0.1").address));
assertEquals(isAddressv4Public(parseAddressv4("10.0.0.1").address), false);
assert(isAddressv4Public(parseAddressv4("8.8.8.8").address));