canirequire › CommonJS › fs-extra
Is fs-extra ESM-only? Can you require() it?
fs-extra contains methods that aren't included in the vanilla Node.js fs package. Such as recursive mkdir, copy, and remove.
Last verified Sep 9, 2026 against fs-extra@11.4.0. JSON
CommonJS CommonJS — require() works on every Node.js version
fs-extra ships CommonJS only. require("fs-extra") works everywhere. import "fs-extra" 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.
Does fs-extra@11.4.0 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("fs-extra") from a CommonJS file and import "fs-extra" from an ES module.
| Runtime | require("fs-extra") | import "fs-extra" |
|---|---|---|
| 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 | ✓ works | ✓ works |
How to import fs-extra
ES modules (import)
import fsExtra from "fs-extra";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 fsExtra = require("fs-extra");Module format by version
Derived from the type, main and exports fields of every stable release on npm (104 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 0.18.4 – 11.4.0 | CommonJS | May 22, 2015 |
Frequently asked
Is fs-extra ESM-only?
fs-extra@11.4.0 is a CommonJS package. fs-extra ships CommonJS only. require("fs-extra") works everywhere. import "fs-extra" 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 fs-extra with ES module syntax?
Yes. import fsExtra from "fs-extra" 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 fs-extra work in Bun?
Yes. import "fs-extra" loaded successfully in Bun 1.4 on Sep 9, 2026.
Does fs-extra ship TypeScript types?
Not bundled. Install the community types with "npm install -D @types/fs-extra".
Links
Other commonjs packages
- debug 4.4.3CommonJS
- semver 7.8.5CommonJS
- ms 2.1.3CommonJS
- picomatch 4.0.7CommonJS
- ajv 8.20.0CommonJS
- source-map 0.8.0CommonJS
- react-is 19.2.8CommonJS
- readable-stream 4.7.0CommonJS
Similar popularity
- hasown 2.0.4CommonJS
- convert-source-map 2.0.0CommonJS
- path-to-regexp 8.4.2CommonJS
- tr46 6.0.0CommonJS
- content-type 3.0.0ESM-only
- @jridgewell/sourcemap-codec 1.6.0Dual
- agent-base 9.0.0ESM-only
- strip-json-comments 5.0.3ESM-only