canirequire › Dual (CommonJS + ESM) › js-yaml
Is js-yaml ESM-only? Can you require() it?
YAML 1.2 parser and serializer
Last verified Sep 9, 2026 against js-yaml@5.4.1. Markdown · JSON
Dual (CommonJS + ESM) Dual package — require() works on every Node.js version we test; import works too
js-yaml publishes both a CommonJS entry and a native ESM entry (ESM added in 4.0.0). require("js-yaml") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "js-yaml" works alongside it.
What to do
- Nothing to change. require("js-yaml") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import * as jsYaml from "js-yaml" works alongside it; use named imports for what the ESM entry exports.
- TypeScript: types are bundled; install nothing extra.
Does js-yaml@5.4.1 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("js-yaml") from a CommonJS file and import "js-yaml" from an ES module.
| Runtime | require("js-yaml") | import "js-yaml" |
|---|---|---|
| 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 js-yaml
ES modules (import)
import * as jsYaml from "js-yaml";Namespace import shown because the ESM entry may have no default export; use named imports for what it exports.
CommonJS (require)
const jsYaml = require("js-yaml");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 (90 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 4.0.0 – 5.4.1 | Dual (CommonJS + ESM) | Jan 3, 2021 |
| 3.2.2 – 3.15.2 | CommonJS | Sep 6, 2014 |
Frequently asked
Is js-yaml ESM-only?
js-yaml@5.4.1 ships CommonJS and ESM builds. js-yaml publishes both a CommonJS entry and a native ESM entry (ESM added in 4.0.0). require("js-yaml") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "js-yaml" works alongside it.
Can I require js-yaml?
Yes. js-yaml ships a CommonJS entry alongside the native ESM entry. require("js-yaml") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun.
Does js-yaml work in Bun?
Yes. import "js-yaml" loaded successfully in Bun 1.4.0 on Sep 9, 2026.
Does js-yaml ship TypeScript types?
Yes. js-yaml bundles its own type declarations; no @types package is needed.
Links
Other dual (commonjs + esm) packages
- minimatch 10.2.6Dual
- brace-expansion 5.0.9Dual
- lru-cache 11.5.2Dual
- tslib 2.8.1Dual
- glob 13.0.6Dual
- eslint-visitor-keys 5.0.1Dual
- yallist 5.0.0Dual
- balanced-match 4.0.4Dual
Similar popularity
- undici-types 8.10.2No entry
- yallist 5.0.0Dual
- safe-buffer 5.2.1CommonJS
- balanced-match 4.0.4Dual
- iconv-lite 0.7.3CommonJS
- uuid 14.0.2ESM-only
- postcss 8.5.28Dual
- mime-db 1.54.0CommonJS