canirequire

canirequire › ESM-only › husky

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

Modern native Git hooks

Last verified Sep 9, 2026 against husky@9.1.7. JSON

ESM-only ESM-only since 9.0.1 — last CommonJS version is 8.0.3

husky dropped its CommonJS build in 9.0.1 (January 2024). The last version you can require() on every Node.js version, including 18 and older, is 8.0.3, published Jan 3, 2023.

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

Latest
9.1.7 (Nov 18, 2024)
Module format
ESM-only
Last CommonJS version
8.0.3
ESM-only since
9.0.1 (Jan 25, 2024)
TypeScript types
Bundled
Node engines
>=18
Weekly downloads
32.0M
License
MIT

Does husky@9.1.7 actually load? Runtime test results

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

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

ES modules (import)

import husky from "husky";

CommonJS (require)

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

// Any Node.js version:
const husky = await import("husky");

// Or pin the last CommonJS release:
// npm install husky@8.0.3

Module format by version

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

VersionsFormatFirst published
9.0.1 – 9.1.7ESM-onlyJan 25, 2024
4.1.0 – 8.0.3CommonJSJan 21, 2020

Frequently asked

Is husky ESM-only?

husky@9.1.7 is ESM-only. husky dropped its CommonJS build in 9.0.1 (January 2024). The last version you can require() on every Node.js version, including 18 and older, is 8.0.3, published Jan 3, 2023.

Which version of husky still supports CommonJS / require()?

8.0.3 is the last version of husky with a CommonJS build. Install it with "npm install husky@8.0.3". Every version from 9.0.1 on is ESM-only.

How do I use husky from a CommonJS file?

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

Does husky work in Bun?

Yes. import "husky" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does husky ship TypeScript types?

Yes. husky bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity