Skip to content

v2.0.0

Choose a tag to compare

@github-actions github-actions released this 30 Sep 11:47
· 3 commits to main since this release

2.0.0 (2026-09-30)

  • docs!: document the upgrade from 1.x (a31f764)

Bug Fixes

  • build correct URLs for params, ports, hosts and hashes (7f8ec6f)
  • harden opaque URLs, backslash hosts and colon segments (b5bd361)
  • keep credentials with international domains (29a9d7b)
  • keep empty values and opaque protocols from changing the URL (2ce2230)
  • keep valid hosts, relative protocols and inline queries intact (3de1436)
  • never create a host out of path fragments or params (d5b6929)
  • never let param values traverse the path or become the host (ab16b68)
  • rewrite the protocol and host reassembly (9df5697)
  • rewrite the URL assembly to fix slashes, hosts, encoding and params (b1847d8)

BREAKING CHANGES

  • Node.js 22 or later is required, and several results
    change because wrong URLs are fixed: undefined and null params are
    skipped, dates are sent as ISO strings, localhost, IPv6 and
    international hosts get a protocol with forceProtocol auto, relative
    paths and file names are no longer taken as domains, a query or hash
    written in the last fragment is kept, the hash keeps / ? : and @, any
    protocol:// and opaque protocols (mailto:, tel:) are kept, the slash
    after a host alone is removed with trailingSlash remove,
    getMakeURLDefaultConfig returns a copy, BASE_DEFAULT_MAKE_URL_CONFIG is
    frozen and the options object can only be the last argument. See
    "Upgrading from 1.x" in the README.