canirequire

canirequire › CommonJS › graceful-fs

Is graceful-fs ESM-only? Can you require() it?

A drop-in replacement for fs, making various improvements.

Last verified Sep 9, 2026 against graceful-fs@4.2.11. JSON

CommonJS CommonJS — require() works on every Node.js version

graceful-fs ships CommonJS only. require("graceful-fs") works everywhere. import "graceful-fs" 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.

Latest
4.2.11 (Mar 16, 2023)
Module format
CommonJS
Last CommonJS version
4.2.11
TypeScript types
@types/graceful-fs
Node engines
not declared
Weekly downloads
174.9M
License
ISC

Does graceful-fs@4.2.11 actually load? Runtime test results

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

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

ES modules (import)

import gracefulFs from "graceful-fs";

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 gracefulFs = require("graceful-fs");

Module format by version

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

VersionsFormatFirst published
1.1.4 – 4.2.11CommonJSJan 19, 2012

Frequently asked

Is graceful-fs ESM-only?

graceful-fs@4.2.11 is a CommonJS package. graceful-fs ships CommonJS only. require("graceful-fs") works everywhere. import "graceful-fs" 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 graceful-fs with ES module syntax?

Yes. import gracefulFs from "graceful-fs" 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 graceful-fs work in Bun?

Yes. import "graceful-fs" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does graceful-fs ship TypeScript types?

Not bundled. Install the community types with "npm install -D @types/graceful-fs".

Links

Other commonjs packages

Similar popularity