tlds

Documentation

Overview

Package tlds provides categorized lists of top-level domains (TLDs) and effective TLDs (eTLDs), including official IANA-approved domains and commonly used pseudo-TLDs.

TLDs represent the highest level in the hierarchical domain name system, while eTLDs include public suffixes such as country code second-level domains (e.g., "co.uk", "gov.in") used for domain registrations. Pseudo-TLDs are unofficial but widely recognized domain suffixes used in specialized networks or alternative domain name systems.

Example Usage:

package main

import (
    "fmt"
    "github.com/hueristiq/hq-go-url/tlds"
)

func main() {
    fmt.Println("Official TLDs:", tlds.Official)
    fmt.Println("Pseudo TLDs:", tlds.Pseudo)
}

References: - IANA TLDs: https://data.iana.org/TLD/tlds-alpha-by-domain.txt - Public Suffix List: https://publicsuffix.org/list/public_suffix_list.dat - A-Z TLDs: https://tld-list.com/tlds-from-a-z - Wikipedia: https://en.wikipedia.org/wiki/Top-level_domain - Pseudo-TLDs: https://en.wikipedia.org/wiki/Pseudo-top-level_domain

This file is autogenerated by ./gen/main.go. Please do not edit manually.

Index

• Variables

Variables

var Official = []string{}/* 7208 elements not displayed */

Official is a sorted list of public top-level domains (TLDs) and effective top-level domains (eTLDs).

TLDs are the highest level in the domain name system, while eTLDs include public suffixes, such as country code second-level domains (e.g., "co.uk" or "gov.in"), commonly used for websites.

References: - IANA TLDs: https://data.iana.org/TLD/tlds-alpha-by-domain.txt - Public Suffix List: https://publicsuffix.org/list/public_suffix_list.dat - A-Z TLDs: https://tld-list.com/tlds-from-a-z - Wikipedia: https://en.wikipedia.org/wiki/Top-level_domain

var Pseudo = []string{
	`bit`,
	`example`,
	`exit`,
	`gnu`,
	`i2p`,
	`invalid`,
	`local`,
	`localhost`,
	`test`,
	`zkey`,
}

Pseudo is a sorted list of widely used unofficial or pseudo top-level domains (TLDs).

These domains are not part of the official IANA TLD registry but serve specific purposes in private networks, special-use cases, or decentralized domain name systems.

References:

• Wikipedia: https://en.wikipedia.org/wiki/Pseudo-top-level_domain
• IETF Draft: https://tools.ietf.org/html/draft-grothoff-iesg-special-use-p2p-names-00
• IANA Special-Use Domains: https://www.iana.org/assignments/special-use-domain-names/special-use-domain-names.xhtml