canirequire › ESM-only › ansi-styles
Is ansi-styles ESM-only? Can you require() it?
ANSI escape codes for styling strings in the terminal
Last verified Sep 9, 2026 against ansi-styles@7.0.0. JSON
ESM-only ESM-only since 6.0.0 — last CommonJS version is 5.2.0
ansi-styles dropped its CommonJS build in 6.0.0 (April 2021). The last version you can require() on every Node.js version, including 18 and older, is 5.2.0, published Mar 31, 2021.
On Node.js 20.19+, 22.12+ and every newer release, require("ansi-styles") 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.
ansi-styles@7.0.0 declares engines ">=22", so Node.js 18, 20 are outside its supported range regardless of module format.
Does ansi-styles@7.0.0 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("ansi-styles") from a CommonJS file and import "ansi-styles" from an ES module.
| Runtime | require("ansi-styles") | import "ansi-styles" |
|---|---|---|
| Node.js 18 | ✗ failsERR_REQUIRE_ESM | ✗ failsSyntaxError |
| 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 ansi-styles
ES modules (import)
import ansiStyles from "ansi-styles";CommonJS (require)
// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const ansiStyles = require("ansi-styles");
// Any Node.js version:
const ansiStyles = await import("ansi-styles");
// Or pin the last CommonJS release:
// npm install ansi-styles@5.2.0Module format by version
Derived from the type, main and exports fields of every stable release on npm (29 versions; the newest 29 shown).
| Versions | Format | First published |
|---|---|---|
| 6.0.0 – 7.0.0 | ESM-only | Apr 16, 2021 |
| 0.1.0 – 5.2.0 | CommonJS | Jul 31, 2013 |
Frequently asked
Is ansi-styles ESM-only?
ansi-styles@7.0.0 is ESM-only. ansi-styles dropped its CommonJS build in 6.0.0 (April 2021). The last version you can require() on every Node.js version, including 18 and older, is 5.2.0, published Mar 31, 2021.
Which version of ansi-styles still supports CommonJS / require()?
5.2.0 is the last version of ansi-styles with a CommonJS build. Install it with "npm install ansi-styles@5.2.0". Every version from 6.0.0 on is ESM-only.
How do I use ansi-styles from a CommonJS file?
Use a dynamic import: const mod = await import("ansi-styles"). On Node.js 20.19+, 22.12+ and newer, a plain require("ansi-styles") also works for ESM packages that do not use top-level await. Alternatively pin ansi-styles@5.2.0.
Does ansi-styles work in Bun?
Yes. import "ansi-styles" loaded successfully in Bun 1.4 on Sep 9, 2026.
Does ansi-styles ship TypeScript types?
Yes. ansi-styles bundles its own type declarations; no @types package is needed.
Links
Other esm-only packages
- 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 - tslib 2.8.1last CJS
2.5.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
- debug 4.4.3CommonJS
- semver 7.8.5CommonJS
- brace-expansion 5.0.9Dual
- ms 2.1.3CommonJS
- strip-ansi 7.2.0ESM-only
- commander 15.0.0ESM-only
- supports-color 11.0.0ESM-only
- chalk 6.0.0ESM-only