canirequire

canirequire › CommonJS › shebang-command

Is shebang-command ESM-only? Can you require() it?

Get the command from a shebang

Last verified Sep 9, 2026 against shebang-command@2.0.0. Markdown · JSON

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

shebang-command ships CommonJS only. require("shebang-command") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=8. import "shebang-command" 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("shebang-command") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=8.
  2. From ES modules use the default import: import shebangCommand from "shebang-command"; then destructure. Named imports only work when Node.js can statically detect the exports.
  3. TypeScript: npm install -D @types/shebang-command
Latest
2.0.0 (Sep 6, 2019)
Module format
CommonJS
Last CommonJS version
2.0.0
TypeScript types
@types/shebang-command
Node engines
>=8
Weekly downloads
121.2M
License
MIT

Does shebang-command@2.0.0 actually load? Runtime test results

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

Runtimerequire("shebang-command")import "shebang-command"
Node.js 18✓ works✓ works
Node.js 20✓ works✓ works
Node.js 22✓ works✓ works
Node.js 24✓ works✓ works
Node.js 26✓ works✓ works
Bun 1.4.0✓ works✓ works

How to import shebang-command

ES modules (import)

import shebangCommand from "shebang-command";

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 shebangCommand = require("shebang-command");

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 (4 versions; the newest 4 shown).

VersionsFormatFirst published
1.0.0 – 2.0.0CommonJSDec 4, 2015

Frequently asked

Is shebang-command ESM-only?

shebang-command@2.0.0 is a CommonJS package. shebang-command ships CommonJS only. require("shebang-command") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=8. import "shebang-command" 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 shebang-command with ES module syntax?

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

Yes. import "shebang-command" loaded successfully in Bun 1.4.0 on Sep 9, 2026.

Does shebang-command ship TypeScript types?

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

Links

Other commonjs packages

Similar popularity