canirequire

canirequire › ESM-only › content-disposition

Is content-disposition ESM-only? Can you require() it?

Create and parse Content-Disposition header

Last verified Sep 9, 2026 against content-disposition@3.0.0. JSON

ESM-only ESM-only since 3.0.0 — last CommonJS version is 2.0.1

content-disposition dropped its CommonJS build in 3.0.0 (August 2026). The last version you can require() on every Node.js version, including 18 and older, is 2.0.1, published May 28, 2026.

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

content-disposition@3.0.0 declares engines ">=22", so Node.js 18, 20 are outside its supported range regardless of module format.

Latest
3.0.0 (Aug 13, 2026)
Module format
ESM-only
Last CommonJS version
2.0.1
ESM-only since
3.0.0 (Aug 13, 2026)
TypeScript types
Bundled
Node engines
>=22
Weekly downloads
127.8M
License
MIT

Does content-disposition@3.0.0 actually load? Runtime test results

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

Runtimerequire("content-disposition")import "content-disposition"
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 content-disposition

ES modules (import)

import contentDisposition from "content-disposition";

CommonJS (require)

// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const contentDisposition = require("content-disposition");

// Any Node.js version:
const contentDisposition = await import("content-disposition");

// Or pin the last CommonJS release:
// npm install content-disposition@2.0.1

Module format by version

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

VersionsFormatFirst published
3.0.0ESM-onlyAug 13, 2026
0.0.0 – 2.0.1CommonJSSep 19, 2014

Frequently asked

Is content-disposition ESM-only?

content-disposition@3.0.0 is ESM-only. content-disposition dropped its CommonJS build in 3.0.0 (August 2026). The last version you can require() on every Node.js version, including 18 and older, is 2.0.1, published May 28, 2026.

Which version of content-disposition still supports CommonJS / require()?

2.0.1 is the last version of content-disposition with a CommonJS build. Install it with "npm install content-disposition@2.0.1". Every version from 3.0.0 on is ESM-only.

How do I use content-disposition from a CommonJS file?

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

Does content-disposition work in Bun?

Yes. import "content-disposition" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does content-disposition ship TypeScript types?

Yes. content-disposition bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity