@uipath/filesystem

@uipath/filesystem

Cross-platform filesystem abstraction for the UiPath CLI. Provides a unified interface for file operations in both Node.js and browser environments.

Installation

npm install @uipath/filesystem

Usage

import { getFileSystem } from "@uipath/filesystem";

const fs = getFileSystem();

// Read a file
const content = await fs.readFile("config.json", "utf-8");

// Write a file (creates directories as needed)
await fs.writeFile("output/result.json", JSON.stringify(data));

// Path operations
const full = fs.path.join(fs.env.homedir(), ".uipath", "config.json");

// Check existence
if (await fs.exists(full)) {
    const stats = await fs.stat(full);
}

API

getFileSystem() / getFileSystemAsync()

Returns a singleton IFileSystem instance.

IFileSystem

Method	Description
readFile(path, options?)	Read file as Uint8Array or UTF-8 string
writeFile(path, data)	Write file, creating parent directories
readdir(path)	List directory contents
stat(path)	Get file stats (type, size, mtime)
exists(path)	Check if path exists
mkdir(path)	Create directory recursively
rm(path)	Remove file or directory recursively
rename(old, new)	Rename or move a file
getTempDir()	Create an isolated temp directory
copyDirectory(src, dest)	Recursive directory copy

Namespaces

Namespace	Description
fs.path	Path operations: join, resolve, relative, dirname, basename, isAbsolute
fs.env	Environment: cwd(), homedir(), tmpdir(), getenv(key)

License

See the root repository for license information.