canirequire

canirequire › ESM-only › normalize-url

Is normalize-url ESM-only? Can you require() it?

Normalize a URL

Last verified Sep 9, 2026 against normalize-url@9.0.1. JSON

ESM-only ESM-only since 7.0.0 — last CommonJS version is 6.1.0

normalize-url dropped its CommonJS build in 7.0.0 (July 2021). The last version you can require() on every Node.js version, including 18 and older, is 6.1.0, published Jun 22, 2021.

On Node.js 20.19+, 22.12+ and every newer release, require("normalize-url") works anyway: Node can load synchronous ES modules through require(). Verified on Node 20, 22, 24, 26. Node.js 18 and older still fail with ERR_REQUIRE_ESM.

normalize-url@9.0.1 declares engines ">=20", so Node.js 18 is outside its supported range regardless of module format.

Latest
9.0.1 (May 20, 2026)
Module format
ESM-only
Last CommonJS version
6.1.0
ESM-only since
7.0.0 (Jul 9, 2021)
TypeScript types
Bundled
Node engines
>=20
Weekly downloads
32.2M
License
MIT

Does normalize-url@9.0.1 actually load? Runtime test results

Installed and executed on Sep 9, 2026 with require("normalize-url") from a CommonJS file and import "normalize-url" from an ES module.

Runtimerequire("normalize-url")import "normalize-url"
Node.js 18✗ failsERR_REQUIRE_ESM✓ works
Node.js 20✓ works✓ works
Node.js 22✓ works✓ works
Node.js 24✓ works✓ works
Node.js 26✓ works✓ works
Bun 1.4✓ works✓ works

How to import normalize-url

ES modules (import)

import normalizeUrl from "normalize-url";

CommonJS (require)

// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const normalizeUrl = require("normalize-url");

// Any Node.js version:
const normalizeUrl = await import("normalize-url");

// Or pin the last CommonJS release:
// npm install normalize-url@6.1.0

Module format by version

Derived from the type, main and exports fields of every stable release on npm (57 versions; the newest 57 shown).

VersionsFormatFirst published
7.0.0 – 9.0.1ESM-onlyJul 9, 2021
1.0.0 – 6.1.0CommonJSJan 11, 2015

Frequently asked

Is normalize-url ESM-only?

normalize-url@9.0.1 is ESM-only. normalize-url dropped its CommonJS build in 7.0.0 (July 2021). The last version you can require() on every Node.js version, including 18 and older, is 6.1.0, published Jun 22, 2021.

Which version of normalize-url still supports CommonJS / require()?

6.1.0 is the last version of normalize-url with a CommonJS build. Install it with "npm install normalize-url@6.1.0". Every version from 7.0.0 on is ESM-only.

How do I use normalize-url from a CommonJS file?

Use a dynamic import: const mod = await import("normalize-url"). On Node.js 20.19+, 22.12+ and newer, a plain require("normalize-url") also works for ESM packages that do not use top-level await. Alternatively pin normalize-url@6.1.0.

Does normalize-url work in Bun?

Yes. import "normalize-url" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does normalize-url ship TypeScript types?

Yes. normalize-url bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity