canirequire

canirequire › CommonJS › whatwg-url

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

An implementation of the WHATWG URL Standard's URL API and parsing machinery

Last verified Sep 9, 2026 against whatwg-url@17.1.0. JSON

CommonJS CommonJS — require() works on every Node.js version

whatwg-url ships CommonJS only. require("whatwg-url") works everywhere. import "whatwg-url" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.

Latest
17.1.0 (Jul 7, 2026)
Module format
CommonJS
Last CommonJS version
17.1.0
TypeScript types
@types/whatwg-url
Node engines
^22.14.0 || >=24.0.0
Weekly downloads
204.4M
License
MIT

Does whatwg-url@17.1.0 actually load? Runtime test results

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

Runtimerequire("whatwg-url")import "whatwg-url"
Node.js 18✗ failsTypeError✗ failsTypeError
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

A failing require() on a CommonJS package usually means the package needs a browser/DOM global, a peer dependency, or a native binary that is not available in a bare Node.js process.

How to import whatwg-url

ES modules (import)

import whatwgUrl from "whatwg-url";

Named imports from a CommonJS package only work when Node.js can statically detect them. If a named import fails, use the default import and destructure.

CommonJS (require)

const whatwgUrl = require("whatwg-url");

Module format by version

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

VersionsFormatFirst published
0.6.2 – 17.1.0CommonJSAug 13, 2015

Frequently asked

Is whatwg-url ESM-only?

whatwg-url@17.1.0 is a CommonJS package. whatwg-url ships CommonJS only. require("whatwg-url") works everywhere. import "whatwg-url" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.

Can I import whatwg-url with ES module syntax?

Yes. import whatwgUrl from "whatwg-url" works in Node.js and Bun because they support importing CommonJS modules. Named imports work only when Node.js can statically detect the exports.

Does whatwg-url work in Bun?

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

Does whatwg-url ship TypeScript types?

Not bundled. Install the community types with "npm install -D @types/whatwg-url".

Links

Other commonjs packages

Similar popularity