tldts is a JavaScript library for extracting hostnames, domains, subdomains, and public suffixes from URLs and hostnames. It also supports parsing email addresses and detecting IPv4 and IPv6, and includes TypeScript type definitions.
Project status
- Active maintenance is evident, with recent
updatesspanning late Sep through Oct 2026 and a very recent upstream push on 2026-10-21. - Update cadence appears steady, roughly every 1 to 3 weeks, often driven by refreshes to the embedded Public Suffix List (PSL) data.
AI summary generated
Recent updates
v7.4.19
v7.4.19 updates the bundled Public Suffix List data and bumps the development tooling dependency typescript-eslint from 8.70.1 to 8.71.0. The diff also includes small internal code changes in the suffix lookup implementation and a minor modification to the trie data logic.
v7.4.18
v7.4.18 updates the bundled public suffix list and regenerates the derived data used by tldts packages (tldts, tldts-icann, tldts-experimental). The release notes also report a set of test and build dependency bumps.
v7.4.16
v7.4.16 is primarily described as an update to the Public Suffix List (PSL) assets. The code diff, however, shows additional internal changes in parsing logic (minor refactors) plus a number of undocumented repository and build/test/tooling updates (TypeScript config, test coverage tooling, CI Node versions, and dev dependency bumps).
v7.4.15
v7.4.15 updates the bundled public suffix list data used by the tld parsing logic and regenerates the corresponding internal trie/hash artifacts. It also bumps several build and test dependencies (rollup, typescript-eslint, @types/node, mocha).
v7.4.14
v7.4.14 is primarily a public suffix list refresh. The release also bumps internal workspace package versions to 7.4.14 and regenerates related packaged data artifacts used by the tldts libraries.
v7.4.13
v7.4.13 updates the bundled Public Suffix List data used by the tldts packages, and bumps the tar dependency to a newer version. The code diff appears limited to refreshed suffix data (and the associated generated data artifacts) plus routine version metadata updates for the workspace packages.
v7.4.12
v7.4.12 updates the embedded Public Suffix List data used by the tldts packages, and it bumps several build and test related dependencies/tooling. The diff shows changes to the generated trie/hash data files plus dependency and version bumps across the monorepo packages.
v7.4.11
v7.4.11 updates the upstream public suffix list and refreshes the generated lookup data used by tldts (public suffix classification tables). It also bumps a set of build and tooling dependencies (brace-expansion, rollup, @types/node, typescript-eslint, nx).
v7.4.10
v7.4.10 updates the bundled Public Suffix List data used by tldts packages. The code changes are limited to refreshed internal PSL data structures (trie and hashes) plus the expected repo version and lockfile alignment to 7.4.10.
v7.4.9
v7.4.9 is primarily a data update release. It updates the upstream public suffix list and regenerates the corresponding lookup data used by tldts, tldts-icann, and tldts-experimental, alongside internal version bumps to 7.4.9.
v7.4.8
Release v7.4.8 primarily updates the upstream public suffix list used by tldts and regenerates related packaged data. The repo also bumps all package versions from 7.4.7 to 7.4.8 and updates the bundled publicsuffix submodule commit.
v7.4.7
v7.4.7 updates the upstream public suffix list used by the tldts packages. In the repo, this manifests as updates to the embedded publicsuffix dataset (git submodule commit) and the generated trie/hash data in the core implementation, plus monorepo version bumps to 7.4.7.
v7.4.6
v7.4.6 updates the upstream Public Suffix List and refreshes the generated trie data used by the tldts packages. It also bumps several build/dev and supply-chain dependencies, including sigstore, @babel/core, rollup tooling, typescript-eslint, and @types/node for the workspace packages.
v7.4.5
v7.4.5 primarily updates the bundled public suffix information used by the tldts libraries. The release notes only mention the upstream public suffix list refresh, and the code diff shows regenerated internal data structures and version bumps to propagate the update across packages.
v7.4.4
Release v7.4.4 updates the upstream public suffix list (PSL). The code diff indicates the PSL-derived internal data structures (trie and hash-related data) were updated accordingly, along with standard monorepo version bumps and changelog entries.
v7.4.3
v7.4.3 updates the bundled public suffix list data used by tldts and regenerates internal lookup structures. It also bumps build tooling dependencies (Rollup and typescript-eslint) and updates package versions to 7.4.3.
v7.4.2
v7.4.2 updates the bundled public suffix list and regenerates related internal data used for domain/TLD parsing. It also bumps the eslint-plugin-prettier dependency (and, via lockfile resolution, some related transitive tooling dependencies).
v7.4.1
v7.4.1 mainly updates the bundled public suffix list data used by tldts across the core and ICANN/experimental variants. The release also bumps a couple of build-time dependencies and adds a README benchmark throughput chart. No code-level API changes (exports or function signatures) are evident in the provided diff.
v7.4.0
v7.4.0 introduces a new API, getFullDomain, across tldts, tldts-icann, and tldts-experimental. It returns the normalized full hostname (subdomain plus registrable domain) when a registrable domain exists, otherwise it returns null.
Featuresv7.3.1
v7.3.1 introduces a targeted bug fix to reject hostnames that contain labels starting with a hyphen. The change is implemented in the core hostname validation logic and reflected by additional test coverage.
Breaking