check-disk-space is a light, multi-platform disk space checker for Node.js that works on Linux, macOS, and Windows. It helps you measure free and total disk space for a given path or mounting point, with TypeScript support and no dependencies. Install via npm and use it to get diskPath, free, and size values (in bytes).
Project status
- The source has updated very recently, with an upstream push and a 4.0.0 update on October 22, 2026.
- Its cadence appears irregular: before 4.0.0, the latest listed update was in May 2023, a gap of over three years.
AI summary generated
Recent updates
4.0.0
Version 4.0.0 migrates the package to ESM with named exports and drops support for Node 16. It also fixes parsing of `df` output with an empty filesystem column, prevents Windows parent-path lookup from looping indefinitely, and updates the test and build toolchain while adding Bun and Deno CI coverage.
BreakingFeaturesv3.4.0
Version 3.4.0 makes the library fully asynchronous by removing synchronous child_process usage and switching internal checks to async/await. The release also adds stricter Node.js engine requirements (Node 16+), improves parsing by removing empty lines from command output, and adjusts packaging for explicit type exports and bundler compatibility.
BreakingSecurityv3.3.1
Release 3.3.1 claims to add a fallback to `wmic` when PowerShell is not available, to avoid crashes. The code changes implement PowerShell availability detection more defensively, but they also introduce an internal API change and a new dependency injection point.
v3.3.0
Release 3.3.0 focuses on restoring disk space checks on older Windows versions by falling back to wmic when PowerShell 3 is unavailable. The release notes describe a single fix related to determining when PowerShell 3 exists so that Get-CimInstance can or cannot be used.
v3.2.0
Release 3.2.0 switches the Windows disk space collection implementation from using `wmic` to using PowerShell. The code diff indicates a single operational change in the Windows command used by `checkDiskSpace`, plus a small repo demo addition and version/package metadata updates.
v3.1.0
Release 3.1.0 is intended to fix how the package can be imported or required by consumers. The release notes state that it now works correctly with both `import` and `require`.
v3.0.1
This release rewrites the package in TypeScript and introduces generated declaration files. It also updates the implementation to address command execution safety and Windows drive letter case sensitivity.
BreakingSecurityFeatures2.1.0
Release 2.1.0 introduces TypeScript support by adding a bundled declaration file for the check-disk-space package. The update also adds a small TypeScript type test file and registers the typings entry in package.json.
Features2.0.0
Release 2.0.0 raises the minimum supported Node.js version. It now requires at least Node.js 8+, primarily due to development dependency updates for security reasons.
BreakingSecurity