canirequire › ESM-only › @semantic-release/npm
Is @semantic-release/npm ESM-only? Can you require() it?
semantic-release plugin to publish a npm package
Last verified Sep 9, 2026 against @semantic-release/npm@13.1.5. Markdown · JSON
ESM-only ESM-only since 10.0.0 — last CommonJS version is 9.0.2
@semantic-release/npm dropped its CommonJS build in 10.0.0 (March 2023). The last version with a plain require()-able CommonJS entry is 9.0.2, published Jan 13, 2023; it declares support for Node.js >=16 || ^14.17.
require("@semantic-release/npm") fails even on Node.js 22.12+ and newer: the package uses top-level await, which require(esm) cannot load (ERR_REQUIRE_ASYNC_MODULE). Use import() instead. Node.js 18 has no require(esm), and @semantic-release/npm@13.1.5 declares Node.js ^22.14.0 || >= 24.10.0, so 18 is outside its supported range anyway.
@semantic-release/npm@13.1.5 declares engines "^22.14.0 || >= 24.10.0", so Node.js 18, 20 are outside its supported range regardless of module format.
What to do
- require("@semantic-release/npm") fails even on Node.js 22.12+ and newer: the package uses top-level await, which require(esm) cannot load (ERR_REQUIRE_ASYNC_MODULE). Use import() instead.
- From a CommonJS file, use a dynamic import inside an async function: const npm = await import("@semantic-release/npm"). That works on every Node.js version the package supports (^22.14.0 || >= 24.10.0).
- If you need a synchronous require() or run Node.js 18: npm install @semantic-release/npm@9.0.2, the last CommonJS release (published Jan 13, 2023); it declares Node.js >=16 || ^14.17.
- @semantic-release/npm@13.1.5 declares engines "^22.14.0 || >= 24.10.0", so Node.js 18, 20 are unsupported regardless: upgrade Node.js or pin an older release.
- TypeScript: no types are available for @semantic-release/npm; declare the module yourself if you need them.
Does @semantic-release/npm@13.1.5 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("@semantic-release/npm") from a CommonJS file and import "@semantic-release/npm" from an ES module.
| Runtime | require("@semantic-release/npm") | import "@semantic-release/npm" |
|---|---|---|
| Node.js 18 | ✗ failsERR_REQUIRE_ESM | ✓ works |
| Node.js 20 | ✗ failsERR_REQUIRE_ASYNC_MODULE | ✓ works |
| Node.js 22 | ✗ failsERR_REQUIRE_ASYNC_MODULE | ✓ works |
| Node.js 24 | ✗ failsERR_REQUIRE_ASYNC_MODULE | ✓ works |
| Node.js 26 | ✗ failsERR_REQUIRE_ASYNC_MODULE | ✓ works |
| Bun 1.4.0 | ✗ failsTypeError | ✓ works |
How to import @semantic-release/npm
ES modules (import)
import * as npm from "@semantic-release/npm";Namespace import shown because the ESM entry may have no default export; use named imports for what it exports.
CommonJS (require)
// Node.js 22.12+ and newer cannot require() this package: it uses top-level await.
// Any Node.js version the package supports (^22.14.0 || >= 24.10.0), from an async function:
async function main() {
const npm = await import("@semantic-release/npm");
}
// Or pin the last CommonJS release (declares Node.js >=16 || ^14.17):
// npm install @semantic-release/npm@9.0.2Module 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 (111 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 10.0.0 – 13.1.5 | ESM-only | Mar 22, 2023 |
| 5.1.7 – 9.0.2 | CommonJS | Apr 14, 2019 |
Frequently asked
Is @semantic-release/npm ESM-only?
@semantic-release/npm@13.1.5 is ESM-only. @semantic-release/npm dropped its CommonJS build in 10.0.0 (March 2023). The last version with a plain require()-able CommonJS entry is 9.0.2, published Jan 13, 2023; it declares support for Node.js >=16 || ^14.17.
Which version of @semantic-release/npm still supports CommonJS / require()?
9.0.2 is the last version of @semantic-release/npm with a CommonJS build; it declares Node.js >=16 || ^14.17. Install it with "npm install @semantic-release/npm@9.0.2". Every version from 10.0.0 on is ESM-only.
How do I use @semantic-release/npm from a CommonJS file?
From a CommonJS file, use a dynamic import inside an async function: const npm = await import("@semantic-release/npm"). That works on every Node.js version the package supports (^22.14.0 || >= 24.10.0). require("@semantic-release/npm") fails even on Node.js 22.12+ and newer: the package uses top-level await, which require(esm) cannot load (ERR_REQUIRE_ASYNC_MODULE). Use import() instead. Alternatively pin @semantic-release/npm@9.0.2 (declares Node.js >=16 || ^14.17).
Does @semantic-release/npm work in Bun?
Yes. import "@semantic-release/npm" loaded successfully in Bun 1.4.0 on Sep 9, 2026.
Does @semantic-release/npm ship TypeScript types?
No. @semantic-release/npm ships no type declarations and there is no @types package for it.
Links
Other esm-only packages
- ansi-styles 7.0.0last CJS
5.2.0 - strip-ansi 7.2.0last CJS
6.0.1 - commander 15.0.0last CJS
14.0.3 - supports-color 11.0.0last CJS
8.1.1 - chalk 6.0.0last CJS
4.1.2 - string-width 8.2.2last CJS
4.2.3 - ansi-regex 6.3.0last CJS
5.0.1 - escape-string-regexp 5.0.0last CJS
4.0.0
Similar popularity
- @angular/cdk 22.1.6ESM-only
- @fortawesome/fontawesome-svg-core 7.3.1Dual
- eslint-plugin-eslint-comments 3.2.0CommonJS
- @semantic-release/github 12.0.9ESM-only
- react-intl 10.1.26ESM-only
- bunyan 1.8.15CommonJS
- karma-chrome-launcher 3.2.0CommonJS
- @semantic-release/commit-analyzer 13.0.1ESM-only