indexeddb-fs

indexeddb-fs

An fs kind of library dedicated to the browser. indexeddb-fs is a module that allows you to store data in the browser using an API similar to that of Node's fs module. It works based on a browser database called IndexedDB.

Motivation

Any other solutions I've found didn't work correctly.

Super quick start

npm install indexeddb-fs --save-dev

import fs from 'indexeddb-fs';

await fs.createDirectory('files');
await fs.createDirectory('/files/private');
await fs.createDirectory('root/files/public');

console.log(await fs.isDirectory('root')); // true
console.log(await fs.isDirectory('files')); // true
console.log(await fs.isDirectory('/files/private')); // true

await fs.writeFile('files/public/file.txt', 'content');

console.log(await fs.isFile('files/public/file.txt')); // true
console.log(await fs.isDirectory('files/public/file.txt')); // false

await fs.removeDirectory(rootDirectoryName);

API

All methods return a Promise. Unfortunately, indexedDB is not a synchronous API :( Every function returns an error when an error occurs. The Promise will be rejected with an Error object.

fs.exists(fullPath)

Parameters: [fullPath: string] Returns: Promise<boolean> Returns true if the path exists, false otherwise.

fs.isFile(fullPath)

Parameters: [fullPath: string] Returns: Promise<boolean> Returns true if the path contains a file, false otherwise.

Throws an error when the path does not contain anything.

fs.isDirectory(fullPath)

Parameters: [fullPath: string] Returns: Promise<boolean> Returns true if the path contains a directory, false otherwise.

Throws an error when the path does not contain anything.

fs.remove(fullPath)

Parameters: [fullPath: string] Returns: Promise<void> Removes files and directories. It does not remove directories recursively!

Throws an error when the path does not contain anything.

fs.details(fullPath)

Parameters: [fullPath: string] Returns: Promise<FileEntry<any> | DirectoryEntry> Returns an object with details about the file or directory.

Throws an error when the path does not contain anything.

Example result for FileEntry<any> type:

{
    type: 'file',
    name: 'file.txt',
    directory: 'root',
    data: 'test 2 content',
    createdAt: 1626882161631,
    fullPath: 'root/file.txt'
}

Example result for DirectoryEntry type:

{
    isRoot: false,
    directory: 'root',
    type: 'directory',
    name: 'directory',
    createdAt: 1626882291087,
    fullPath: 'root/directory'
}

fs.writeFile(fullPath, data)

Parameters: [fullPath: string, data: TData] Returns: Promise<FileEntry<TData>> Writes data to the file, replacing the file if it already exists. data can be everything that you want.

Throws an error when the destination directory of the file does not exist. Throws an error when the path contains a directory with the same name.

Example result for FileEntry<TData> type:

{
    type: 'file',
    name: 'file.txt',
    directory: 'root',
    data: 'test 2 content',
    createdAt: 1626882161631,
    fullPath: 'root/file.txt'
}

fs.readFile(fullPath)

Parameters: [fullPath: string] Returns: Promise<TData> Reads the entire contents of a file. The returned data type has the same type with which it was saved.

Throws an error when the destination file does not exist. Throws an error when the destination file is not a file.

fs.removeFile(fullPath)

Parameters: [fullPath: string] Returns: Promise<void>

Throws an error when the path does not contain anything. Throws an error when the destination file is not a file.

fs.createDirectory(fullPath)

Parameters: [fullPath: string] Returns: Promise<DirectoryEntry>

Creates a directory at fullPath and returns a Promise.

Throws an error when the destination directory of the directory does not exist. Throws an error when the path contains a file with the same name.

Example result for DirectoryEntry type:

{
    isRoot: false,
    directory: 'root',
    type: 'directory',
    name: 'directory',
    createdAt: 1626882291087,
    fullPath: 'root/directory'
}

fs.readDirectory(fullPath)

Parameters: [fullPath: string] Returns: Promise<ReadDirectoryDecoratorOutput> Reads the entire contents of a directory.

Throws an error when the destination directory does not exist. Throws an error when the destination directory is not a directory.

Example result for ReadDirectoryDecoratorOutput type:

{
    files: [],
    filesCount: 0,
    isEmpty: true,
    directories: [],
    directoriesCount: 0,
}

fs.removeDirectory(fullPath)

Parameters: [fullPath: string] Returns: Promise<void> Removes the directory, recursively removing any files/subdirectories contained within.

Throws an error when the destination directory does not exist. Throws an error when the destination directory is not a directory.

License

MIT