Class CachedFileSystemAdapter

Decorate any existing file system with caching functionality; caches the write and stat operations towards the target file system. The methods readDirectory and findFiles are not cached and will be redirected to the base file system.

Hierarchy (View Summary)

FileSystem
- CachedFileSystemAdapter

Index

Constructors

constructor

new CachedFileSystemAdapter(innerFs: FileSystem): CachedFileSystemAdapter
Parameters
- innerFs: FileSystem
Returns CachedFileSystemAdapter
Overrides FileSystem.constructor
- Defined in packages/core/src/fs/cachedFileSystem.ts:10

Properties

`Private` `Readonly`innerFs

innerFs: FileSystem

Methods

appendFile

appendFile(
    path: string,
    body: string | Buffer<ArrayBufferLike>,
    options?: OutputOptions,
): Promise<void>
Append data to an existing file to the file system, when the directory does not exists it will be created.
Parameters
- path: string
  path to the file to read
- body: string | Buffer<ArrayBufferLike>
  body to write to the file
- Optionaloptions: OutputOptions
  write options
Returns Promise<void>
Inherited from FileSystem.appendFile
- Defined in packages/core/src/fs/fileSystem.ts:227

clearCache

clearCache(): void
Returns void
- Defined in packages/core/src/fs/cachedFileSystem.ts:18

createDirectory

createDirectory(path: string): Promise<void>
Create a new directory at the specified path. No error should be thrown when the directory already exists. Operations should be idempotent and recursive, so when creating a directory /a/b/c and /a or /a/b do not exists, these should be created as well.
Parameters
- path: string
  path to the directory to create
Returns Promise<void>
Overrides FileSystem.createDirectory
- Defined in packages/core/src/fs/cachedFileSystem.ts:46

find

find(patterns: GlobPatterns, options?: FindOptions): AsyncGenerator<string>
Find files and or folders matching the specified glob pattern as an async iterable. If the result is not iterated completely, the search is stopped. When you need the results as an array, use the Iterable.spreadAsync method to convert the async iterable into an array.

By default the current working directory is used as the base directory for the search.

You can specify multiple glob patterns to match by specifying an array of glob patterns.

When a limit is specified, the search is stopped after the specified number of results is reached.

When a depth is specified, the search does not go deeper than the specified depth.
Parameters
- patterns: GlobPatterns
  Glob patterns to match
- Optionaloptions: FindOptions
  find options
Returns AsyncGenerator<string>
Async iterable of matching files and or folders
Example
```
for await (const file of fs.find('*.ts')) {
    console.log(file);
}
```
Inherited from FileSystem.find
- Defined in packages/core/src/fs/fileSystem.ts:187

findFiles

findFiles(patterns: string | string[]): Promise<string[]>
Find files matching the specified glob pattern(s)
Parameters
- patterns: string | string[]
Returns Promise<string[]>
Overrides FileSystem.findFiles
- Defined in packages/core/src/fs/cachedFileSystem.ts:38

`Protected` `Optional`globFs

globFs?(): Partial<FileSystemAdapter>
Returns Partial<FileSystemAdapter>
Inherited from FileSystem.globFs
- Defined in packages/core/src/fs/fileSystem.ts:272

isDirectory

isDirectory(path: string): Promise<boolean>
Returns true if the path exists and is a folder, returns false when the path does not exists or is not a folder.
Parameters
- path: string
  Path to check
Returns Promise<boolean>
Inherited from FileSystem.isDirectory
- Defined in packages/core/src/fs/fileSystem.ts:129

isFile

isFile(path: string): Promise<boolean>
Returns true if the path exists and is a file, returns false when the path does not exists or is not a file.
Parameters
- path: string
  Path to check
Returns Promise<boolean>
Inherited from FileSystem.isFile
- Defined in packages/core/src/fs/fileSystem.ts:121

outputFile

outputFile(
    path: string,
    body?: string | Buffer<ArrayBufferLike>,
    options?: OutputOptions,
): Promise<void>
Write a file to the file system, when the directory does not exists it will be created.
Parameters
- path: string
  path to the file to read
- Optionalbody: string | Buffer<ArrayBufferLike>
  body to write to the file
- Optionaloptions: OutputOptions
  write options
Returns Promise<void>
Inherited from FileSystem.outputFile
- Defined in packages/core/src/fs/fileSystem.ts:154

pathExists

pathExists(path: string): Promise<boolean>
Checks if the specified path exists on the file system
Parameters
- path: string
  Path to check
Returns Promise<boolean>
Inherited from FileSystem.pathExists
- Defined in packages/core/src/fs/fileSystem.ts:137

readDirectory

readDirectory(path: string): Promise<FileInfo[]>
Read the contents of a directs; returns an array with the files and folders contained in the specified directory.
Parameters
- path: string
  Directory
Returns Promise<FileInfo[]>
Overrides FileSystem.readDirectory
- Defined in packages/core/src/fs/cachedFileSystem.ts:33

readFile

readFile(fileName: string): Promise<Buffer<ArrayBufferLike>>
Reads the specified file path into a NodeJS Buffer object
Parameters
- fileName: string
Returns Promise<Buffer<ArrayBufferLike>>
Overrides FileSystem.readFile
- Defined in packages/core/src/fs/cachedFileSystem.ts:23

readFileAsString

readFileAsString(fileName: string, encoding?: BufferEncoding): Promise<string>
Read a file and returns the file body as String
Parameters
- fileName: string
- encoding: BufferEncoding = 'utf-8'
Returns Promise<string>
Overrides FileSystem.readFileAsString
- Defined in packages/core/src/fs/cachedFileSystem.ts:14

stat

stat(path: string, options?: StatsOptions): Promise<undefined | FileStat>
Get file statistics; returns undefined when the file does not exists
Parameters
- path: string
  Path to check
- Optionaloptions: StatsOptions
Returns Promise<undefined | FileStat>
Overrides FileSystem.stat
- Defined in packages/core/src/fs/cachedFileSystem.ts:28

writeFile

writeFile(path: string, data: Buffer, options?: WriteOptions): Promise<void>
Write a file to the file system, when the directory does not exists it will be created.
Parameters
- path: string
  path to the file to read
- data: Buffer
  data to write to the file
- Optionaloptions: WriteOptions
  write options
Returns Promise<void>
Overrides FileSystem.writeFile
- Defined in packages/core/src/fs/cachedFileSystem.ts:42

Class CachedFileSystemAdapter

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns CachedFileSystemAdapter

Properties

Private ReadonlyinnerFs

Methods

appendFile

Parameters

Returns Promise<void>

clearCache

Returns void

createDirectory

Parameters

Returns Promise<void>

find

Parameters

Returns AsyncGenerator<string>

Example

findFiles

Parameters

Returns Promise<string[]>

Protected OptionalglobFs

Returns Partial<FileSystemAdapter>

isDirectory

Parameters

Returns Promise<boolean>

isFile

Parameters

Returns Promise<boolean>

outputFile

Parameters

Returns Promise<void>

pathExists

Parameters

Returns Promise<boolean>

readDirectory

Parameters

Returns Promise<FileInfo[]>

readFile

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

readFileAsString

Parameters

Returns Promise<string>

stat

Parameters

Returns Promise<undefined | FileStat>

writeFile

Parameters

Returns Promise<void>

Settings

On This Page

`Private` `Readonly`innerFs

`Protected` `Optional`globFs