Add toRegistrableDomain function for domain normalization

2026-09-23 00:15:31 -04:00 · 2025-10-10 10:44:04 -04:00
parent bfcecc5eff
commit 6070d91424
5 changed files with 75 additions and 100 deletions
@@ -35,6 +35,16 @@ await isRegistered("example.com"); // => true
 await isAvailable("likely-unregistered-thing-320485230458.com"); // => false
 ```

+Normalize arbitrary input (domain or URL) to its registrable domain (eTLD+1):
+
+```ts
+import { toRegistrableDomain } from "rdapper";
+
+toRegistrableDomain("https://sub.example.co.uk/page"); // => "example.co.uk"
+toRegistrableDomain("spark-public.s3.amazonaws.com");   // => "amazonaws.com" (ICANN-only default)
+toRegistrableDomain("192.168.0.1");                      // => null
+```
+
 ## API

 - `lookupDomain(domain, options?) => Promise<LookupResult>`