canirequire

canirequire › CommonJS › jsdom

Is jsdom ESM-only? Can you require() it?

A JavaScript implementation of many web standards

Last verified Sep 9, 2026 against jsdom@30.0.1. Markdown · JSON

CommonJS CommonJS — require() works on Node.js 22, 24 and 26, fails on 18 and 20

jsdom ships CommonJS only. require("jsdom") works on Node.js 22, 24 and 26 but fails on Node.js 18 and 20 (ERR_REQUIRE_ESM). The package declares Node.js ^22.22.2 || ^24.15.0 || >=26.0.0. import "jsdom" 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.

What to do

  1. require("jsdom") works on Node.js 22, 24 and 26 but fails on Node.js 18 and 20 (ERR_REQUIRE_ESM). The package declares Node.js ^22.22.2 || ^24.15.0 || >=26.0.0.
  2. From ES modules use the default import: import jsdom from "jsdom"; then destructure. Named imports only work when Node.js can statically detect the exports.
  3. TypeScript: npm install -D @types/jsdom
Latest
30.0.1 (Jul 29, 2026)
Module format
CommonJS
Last CommonJS version
30.0.1
TypeScript types
@types/jsdom
Node engines
^22.22.2 || ^24.15.0 || >=26.0.0
Weekly downloads
88.3M
License
MIT

Does jsdom@30.0.1 actually load? Runtime test results

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

Runtimerequire("jsdom")import "jsdom"
Node.js 18✗ failsERR_REQUIRE_ESM✗ failsERR_REQUIRE_ESM
Node.js 20✗ failsTypeError✗ failsTypeError
Node.js 22✓ works✓ works
Node.js 24✓ works✓ works
Node.js 26✓ works✓ works
Bun 1.4.0✓ 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 jsdom

ES modules (import)

import jsdom from "jsdom";

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 jsdom = require("jsdom");

Module format by version

Derived from the type, main and exports fields of every stable release on npm, corrected where a runtime test of that version contradicted them (274 versions; the newest 60 shown).

VersionsFormatFirst published
15.2.0 – 30.0.1CommonJSOct 14, 2019

Frequently asked

Is jsdom ESM-only?

jsdom@30.0.1 is a CommonJS package. jsdom ships CommonJS only. require("jsdom") works on Node.js 22, 24 and 26 but fails on Node.js 18 and 20 (ERR_REQUIRE_ESM). The package declares Node.js ^22.22.2 || ^24.15.0 || >=26.0.0. import "jsdom" 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 jsdom with ES module syntax?

Yes. import jsdom from "jsdom" 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 jsdom work in Bun?

Yes. import "jsdom" loaded successfully in Bun 1.4.0 on Sep 9, 2026.

Does jsdom ship TypeScript types?

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

Links

Other commonjs packages

Similar popularity