canirequire

canirequire › ESM-only › lint-staged

Is lint-staged ESM-only? Can you require() it?

Lint files staged by git

Last verified Sep 9, 2026 against lint-staged@17.5.0. JSON

ESM-only ESM-only since 12.0.0 — last CommonJS version is 11.2.6

lint-staged dropped its CommonJS build in 12.0.0 (November 2021). The last version you can require() on every Node.js version, including 18 and older, is 11.2.6, published Oct 26, 2021.

On Node.js 20.19+, 22.12+ and every newer release, require("lint-staged") 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.

lint-staged@17.5.0 declares engines ">=22.22.1", so Node.js 18, 20 are outside its supported range regardless of module format.

Latest
17.5.0 (Sep 5, 2026)
Module format
ESM-only
Last CommonJS version
11.2.6
ESM-only since
12.0.0 (Nov 13, 2021)
TypeScript types
Bundled
Node engines
>=22.22.1
Weekly downloads
26.0M
License
MIT

Does lint-staged@17.5.0 actually load? Runtime test results

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

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

ES modules (import)

import lintStaged from "lint-staged";

CommonJS (require)

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

// Any Node.js version:
const lintStaged = await import("lint-staged");

// Or pin the last CommonJS release:
// npm install lint-staged@11.2.6

Module format by version

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

VersionsFormatFirst published
15.0.0 – 17.5.0ESM-onlyOct 14, 2023

Frequently asked

Is lint-staged ESM-only?

lint-staged@17.5.0 is ESM-only. lint-staged dropped its CommonJS build in 12.0.0 (November 2021). The last version you can require() on every Node.js version, including 18 and older, is 11.2.6, published Oct 26, 2021.

Which version of lint-staged still supports CommonJS / require()?

11.2.6 is the last version of lint-staged with a CommonJS build. Install it with "npm install lint-staged@11.2.6". Every version from 12.0.0 on is ESM-only.

How do I use lint-staged from a CommonJS file?

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

Does lint-staged work in Bun?

Yes. import "lint-staged" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does lint-staged ship TypeScript types?

Yes. lint-staged bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity