feat(unstable): add Deno.networkInterfaces (#13475)

2 files changed, 55 insertions, 0 deletions

diff --git a/cli/dts/lib.deno.unstable.d.ts b/cli/dts/lib.deno.unstable.d.ts
index 74ba8d796..28ea314f3 100644
--- a/cli/dts/lib.deno.unstable.d.ts
+++ b/cli/dts/lib.deno.unstable.d.ts
@@ -103,6 +103,36 @@ declare namespace Deno {
     swapFree: number;
   }
 
+  /** The information of the network interface */
+  export interface NetworkInterfaceInfo {
+    /** The network interface name */
+    name: string;
+    /** The IP protocol version */
+    family: "IPv4" | "IPv6";
+    /** The IP address */
+    address: string;
+    /** The netmask */
+    netmask: string;
+    /** The IPv6 scope id or null */
+    scopeid: number | null;
+    /** The CIDR range */
+    cidr: string;
+    /** The MAC address */
+    mac: string;
+  }
+
+  /** **Unstable** new API. yet to be vetted.
+   *
+   * Returns an array of the network interface informations.
+   *
+   * ```ts
+   * console.log(Deno.networkInterfaces());
+   * ```
+   *
+   * Requires `allow-env` permission.
+   */
+  export function networkInterfaces(): NetworkInterfaceInfo[];
+
   /** All possible types for interfacing with foreign functions */
   export type NativeType =
     | "void"
diff --git a/cli/tests/unit/network_interfaces_test.ts b/cli/tests/unit/network_interfaces_test.ts
new file mode 100644
index 000000000..120f58763
--- /dev/null
+++ b/cli/tests/unit/network_interfaces_test.ts
@@ -0,0 +1,25 @@
+import { assert } from "./test_util.ts";
+
+Deno.test(
+  { name: "Deno.networkInterfaces", permissions: { env: true } },
+  () => {
+    const networkInterfaces = Deno.networkInterfaces();
+    assert(Array.isArray(networkInterfaces));
+    assert(networkInterfaces.length > 0);
+    for (
+      const { name, family, address, netmask, scopeid, cidr, mac }
+        of networkInterfaces
+    ) {
+      assert(typeof name === "string");
+      assert(family === "IPv4" || family === "IPv6");
+      assert(typeof address === "string");
+      assert(typeof netmask === "string");
+      assert(
+        (family === "IPv6" && typeof scopeid === "number") ||
+          (family === "IPv4" && scopeid === null),
+      );
+      assert(typeof cidr === "string");
+      assert(typeof mac === "string");
+    }
+  },
+);