Novadesk Docs

Appearance

disk Module ​

Read disk space and usage metrics in Novadesk.

The disk module is exported from the system module.

javascript
import { disk } from "system";

Table of Contents ​

disk.totalBytes([path]) ​

Returns total disk capacity in bytes.

Parameters ​

  • path
    • Type: string
    • Required: No
    • Description: File or drive path to query (for example, "C:\\").

Return Value ​

  • Type: number
  • Description: Total bytes for the target volume. Returns 0 if unavailable.

disk.availableBytes([path]) ​

Returns available bytes for the current user on the target volume.

Parameters ​

  • path
    • Type: string
    • Required: No
    • Description: File or drive path to query.

Return Value ​

  • Type: number
  • Description: Available bytes for the target volume. Returns 0 if unavailable.

disk.usedBytes([path]) ​

Returns used bytes for the target volume.

Parameters ​

  • path
    • Type: string
    • Required: No
    • Description: File or drive path to query.

Return Value ​

  • Type: number
  • Description: Used bytes for the target volume. Returns 0 if unavailable.

disk.usagePercent([path]) ​

Returns disk usage percentage for the target volume.

Parameters ​

  • path
    • Type: string
    • Required: No
    • Description: File or drive path to query.

Return Value ​

  • Type: number
  • Description: Usage percent (0-100) for the target volume. Returns 0 if unavailable.

INFO

If path is omitted, the API uses the current working drive/root.

Example ​

javascript
import { disk } from "system";

const path = "C:\\";

const total = disk.totalBytes(path);
const available = disk.availableBytes(path);
const used = disk.usedBytes(path);
const percent = disk.usagePercent(path);

console.log("Total:", total);
console.log("Available:", available);
console.log("Used:", used);
console.log("Usage %:", percent);