@amilajack/diskusage
v0.0.1
Published
Get total diskspace and free diskspace using bindings around platform specific calls.
Downloads
17
Maintainers
Readme
node-diskusage
This module implements platform specific bindings to obtain disk usage information on Windows and POSIX platforms. Windows support is backed by GetDiskFreeSpaceEx and POSIX is implemented with statvfs.
Installation
$ npm install @amilajack/diskusage
Usage
The module exposes two functions. check
takes a path/mount point as the first argument and a callback as the second. The callback takes two arguments err
and info
. err
will be an Error
if something went wrong. info
contains three members: available
, free
and total
in bytes.
available
: Disk space available to the current user (i.e. Linux reserves 5% for root)free
: Disk space physically freetotal
: Total disk space (free + used)
checkSync
only takes the path argument. It returns the same info
on success, throws an Error
on failure.
Examples
import disk from '@amilajck/diskusage';
import os from 'os';
const path = os.platform() === 'win32' ? 'c:' : '/';
const info = disk.checkSync(path);
console.log(info.available);
console.log(info.free);
console.log(info.total);