import { urlNormalize } from "url-normalize" urlNormalize("example.com") // -> "https://example.com" urlNormalize("//www.example.com:443/../foo/bar?b=2&a=1#tag") // -> "https://example.com/foo/bar?a=1&b=2#tag" // all invalid urls is null urlNormalize("example") // -> null urlNormalize("data:content/type;base64,abc") // -> null urlNormalize("tel:+123456789") // -> null urlNormalize("mailto:user@example.com") // -> null

urlNormalize("example.com", { defaultProtocol: "http" }) // -> "http://example.com" urlNormalize("example.com", { defaultProtocol: "ftps" }) // -> ftps://example.com // BUT keeps original protocol if it in url urlNormalize("https://example.com", { defaultProtocol: "http" }) // -> "https://example.com"

urlNormalize("https://example.com") // -> "https://example.com" urlNormalize("https://example.com", { protocol: false }) // -> "example.com" urlNormalize("https://example.com/foo?bar=baz", { protocol: false }) // -> "example.com/foo?bar=baz"

urlNormalize("www.example.com") // -> "https://example.com" urlNormalize("www.example.com", { www: true }) // -> "https://www.example.com"

urlNormalize("https://user:pass@example.com") // -> "https://example.com" urlNormalize("https://user:pass@example.com", { auth: true }) // -> "https://user:pass@example.com"

urlNormalize("https://example.com:8080") // -> "https://example.com" urlNormalize("https://example.com:8080", { port: true }) // -> "https://example.com:8080" // BUT for HTTP - 80 & HTTPS - 443 always without port urlNormalize("https://example.com:443", { port: true }) // -> "https://example.com"

urlNormalize("example.com/index.html") // -> "https://example.com/index.html" urlNormalize("example.com/index.html", { index: false }) // -> "https://example.com"

urlNormalize("example.com/?a=1&b=2") // -> "https://example.com/?a=1&b=2" urlNormalize("example.com/?a=1&b=2", { search: false }) // -> "https://example.com"

urlNormalize("example.com/?b=2&b=1") // -> "https://example.com/?a=1&b=2" urlNormalize("example.com/?b=2&b=1", { sortSearch: false }) // -> "https://example.com/?b=2&b=1"

urlNormalize("example.com/?c=3&b=2&a=1", { filterSearch: (k, v) => k === "a" || v === "3" }) // -> https://example.com/?a=1&c=3

urlNormalize("example.com/#foo") // -> "https://example.com/#foo" urlNormalize("example.com/?b=2&b=1", { fragment: false }) // -> "https://example.com"

urlNormalize("example.com/#:~:text=hello") // -> "https://example.com" urlNormalize("example.com/?b=2&b=1", { textFragment: true }) // -> "https://example.com/#:~:text=hello"

urlNormalize("ftps://example.com") // -> null urlNormalize("tg://example.com") // -> null urlNormalize("ftps://example.com", { customProtocol: true }) // -> "ftps://example.com" urlNormalize("tg://example.com", { customProtocol: true }) // -> "tg://example.com"

urlNormalize("https://example.com", { forceProtocol: "sftp" }) // -> "sftp://example.com" urlNormalize("tg://example.com", { forceProtocol: "we" }) // -> "we://example.com"

urlNormalize("👻💥.ws") // -> "https://xn--9q8huc.ws" urlNormalize("👻💥.ws", { unicode: true }) // -> "https://👻💥.ws" urlNormalize("https://xn--9q8huc.ws", { unicode: true }) // -> "https://👻💥.ws"

import { createUrlNormalize } from "url-normalize" const urlNormalize = createUrlNormalize({ defaultProtocol: "http", fragment: false, }) urlNormalize("example.com/foo#tag") // -> "http://example.com/foo"

import { urlNormalize, urlNormalizeOrFail } from "url-normalize" urlNormalize("invalid") // -> null urlNormalizeOrFail("invalid") // throws Exception

import { extractDomain, extractDomainOrFail } from "url-normalize" extractDomain("https://example.com:8080/?a=1&b=2#tag") // -> "example.com" extractDomain("invalid") // -> null extractDomainOrFail("invalid") // throws Exception

import { humanizeUrl, humanizeUrlOrFail } from "url-normalize" humanizeUrl("https://example.com/foo/bar") // -> example.com/foo/bar humanizeUrl("invalid") // -> null humanizeUrlOrFail("invalid") // throws Exception