Class DeviceFS

A temporary file system that manages and interfaces with devices

Hierarchy (view full)

StoreFS<InMemoryStore>
- DeviceFS

Constructors

constructor

new DeviceFS(): DeviceFS
Returns DeviceFS
Overrides StoreFS.constructor
- Defined in src/devices.ts:258

Properties

`Protected` `Optional` `Internal`_disableSync

_disableSync?: boolean

Whether the sync cache should be disabled. Only affects async things.

`Protected` `Readonly`devices

devices: Map<string, Device<any>> = ...

`Protected`store

store: InMemoryStore

Methods

`Protected`_findInodeSync

_findInodeSync(tx, path, syscall, visited?): bigint
Helper function for findINode.
Parameters
- tx: Transaction<Store>
- path: string
- syscall: string
- visited: Set<string> = ...
Returns bigint
string The ID of the file's inode in the file system.
Inherited from StoreFS._findInodeSync
- Defined in src/backends/store/fs.ts:390

addDefaults

addDefaults(): void
Adds default devices

Returns void
- Defined in src/devices.ts:251

checkRoot

checkRoot(): Promise<void>
Checks if the root directory exists. Creates it if it doesn't.

Returns Promise<void>
Inherited from StoreFS.checkRoot
- Defined in src/backends/store/fs.ts:322

checkRootSync

checkRootSync(): void
Checks if the root directory exists. Creates it if it doesn't.

Returns void
Inherited from StoreFS.checkRootSync
- Defined in src/backends/store/fs.ts:340

createDevice

createDevice<TData>(path, driver): Device<TData | Record<string, never>>
Creates a new device at path relative to the DeviceFS root.
Type Parameters
- TData = any
Parameters
- path: string
- driver: DeviceDriver<TData>
Returns Device<TData | Record<string, never>>
- Defined in src/devices.ts:230

createFile

createFile(path, flag, mode): Promise<File<FileSystem>>
Create the file at path with mode. Then, open it with flag.
Parameters
- path: string
- flag: string
- mode: number
Returns Promise<File<FileSystem>>
Overrides StoreFS.createFile
- Defined in src/devices.ts:312

createFileSync

createFileSync(path, flag, mode): File<FileSystem>
Create the file at path with mode. Then, open it with flag.
Parameters
- path: string
- flag: string
- mode: number
Returns File<FileSystem>
Overrides StoreFS.createFileSync
- Defined in src/devices.ts:319

empty

empty(): Promise<void>
Delete all contents stored in the file system.

Returns Promise<void>
Deprecated
Inherited from StoreFS.empty
- Defined in src/backends/store/fs.ts:50

emptySync

emptySync(): void
Delete all contents stored in the file system.

Returns void
Deprecated
Inherited from StoreFS.emptySync
- Defined in src/backends/store/fs.ts:60

exists

exists(path): Promise<boolean>
Test whether or not path exists.
Parameters
- path: string
Returns Promise<boolean>
Inherited from StoreFS.exists
- Defined in src/filesystem.ts:148

existsSync

existsSync(path): boolean
Test whether or not path exists.
Parameters
- path: string
Returns boolean
Inherited from StoreFS.existsSync
- Defined in src/filesystem.ts:160

`Protected`findInodeSync

findInodeSync(tx, path, syscall, visited?): Inode
Finds the Inode of path.
Parameters
- tx: Transaction<Store>
- path: string
  The path to look up.
- syscall: string
- visited: Set<string> = ...
Returns Inode
The Inode of the path p.

Todo
memoize/cache
Inherited from StoreFS.findInodeSync
- Defined in src/backends/store/fs.ts:428

link

link(target, link): Promise<void>
Parameters
- target: string
- link: string
Returns Promise<void>
Overrides StoreFS.link
- Defined in src/devices.ts:382

linkSync

linkSync(target, link): void
Parameters
- target: string
- link: string
Returns void
Overrides StoreFS.linkSync
- Defined in src/devices.ts:392

metadata

metadata(): FileSystemMetadata
Get metadata about the current file system

Returns FileSystemMetadata
Inherited from StoreFS.metadata
- Defined in src/backends/store/fs.ts:39

mkdir

mkdir(path, mode): Promise<void>
Parameters
- path: string
- mode: number
Returns Promise<void>
Overrides StoreFS.mkdir
- Defined in src/devices.ts:348

mkdirSync

mkdirSync(path, mode): void
Parameters
- path: string
- mode: number
Returns void
Overrides StoreFS.mkdirSync
- Defined in src/devices.ts:355

openFile

openFile(path, flag): Promise<File<FileSystem>>
Opens the file at path with flag. The file must exist.
Parameters
- path: string
  The path to open.
- flag: string
  The flag to use when opening the file.
Returns Promise<File<FileSystem>>
Overrides StoreFS.openFile
- Defined in src/devices.ts:298

openFileSync

openFileSync(path, flag): File<FileSystem>
Opens the file at path with flag. The file must exist.
Parameters
- path: string
  The path to open.
- flag: string
  The flag to use when opening the file.
Returns File<FileSystem>
Overrides StoreFS.openFileSync
- Defined in src/devices.ts:305

readdir

readdir(path): Promise<string[]>
Parameters
- path: string
Returns Promise<string[]>
Overrides StoreFS.readdir
- Defined in src/devices.ts:362

readdirSync

readdirSync(path): string[]
Parameters
- path: string
Returns string[]
Overrides StoreFS.readdirSync
- Defined in src/devices.ts:372

ready

ready(): Promise<void>
Returns Promise<void>
Inherited from StoreFS.ready
- Defined in src/backends/store/fs.ts:27

rename

rename(oldPath, newPath): Promise<void>
Parameters
- oldPath: string
- newPath: string
Returns Promise<void>
Todo
Make rename compatible with the cache.
Overrides StoreFS.rename
- Defined in src/devices.ts:262

renameSync

renameSync(oldPath, newPath): void
Parameters
- oldPath: string
- newPath: string
Returns void
Overrides StoreFS.renameSync
- Defined in src/devices.ts:272

rmdir

rmdir(path): Promise<void>
Parameters
- path: string
Returns Promise<void>
Overrides StoreFS.rmdir
- Defined in src/devices.ts:340

rmdirSync

rmdirSync(path): void
Parameters
- path: string
Returns void
Overrides StoreFS.rmdirSync
- Defined in src/devices.ts:344

stat

stat(path): Promise<Stats>
Parameters
- path: string
Returns Promise<Stats>
Overrides StoreFS.stat
- Defined in src/devices.ts:282

statSync

statSync(path): Stats
Parameters
- path: string
Returns Stats
Overrides StoreFS.statSync
- Defined in src/devices.ts:290

sync

sync(path, data, stats): Promise<void>
Updated the inode and data node at path
Parameters
- path: string
- data: Uint8Array
- stats: Readonly<Stats>
Returns Promise<void>
Todo
Ensure mtime updates properly, and use that to determine if a data update is required.
Overrides StoreFS.sync
- Defined in src/devices.ts:402

syncSync

syncSync(path, data, stats): void
Updated the inode and data node at path
Parameters
- path: string
- data: Uint8Array
- stats: Readonly<Stats>
Returns void
Todo
Ensure mtime updates properly, and use that to determine if a data update is required.
Overrides StoreFS.syncSync
- Defined in src/devices.ts:409

unlink

unlink(path): Promise<void>
Parameters
- path: string
Returns Promise<void>
Overrides StoreFS.unlink
- Defined in src/devices.ts:326

unlinkSync

unlinkSync(path): void
Parameters
- path: string
Returns void
Overrides StoreFS.unlinkSync
- Defined in src/devices.ts:333