Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface FileSystemProviderWithFileReadWriteCapability

Subtype of FileSystemProvider that ensures that the optional functions, needed for providers that should be able to read & write files, are implemented.

Hierarchy

Implemented by

Index

Properties

Readonly capabilities

The FileSystemProviderCapabilities for this provider.

Readonly onDidChangeCapabilities

onDidChangeCapabilities: Event<void>

Event that is fired if the capabilities of this provider have changed.

Readonly onDidChangeFile

onDidChangeFile: Event<readonly FileChange[]>

Event that is fired if a (watched) file in the filesystem of this provider has changed.

Readonly onFileWatchError

onFileWatchError: Event<void>

Event that is fired if an error occurred when watching files in the filesystem of this provider.

Methods

Optional access

  • access(resource: default, mode?: number): Promise<void>

Optional close

  • close(fd: number): Promise<void>

Optional copy

delete

  • Delete the given resource.

    Parameters

    • resource: default

      The URI of the resource to delete.

    • opts: FileDeleteOptions

      Options to define if files should be deleted recursively and if the trash should be used.

    Returns Promise<void>

Optional fsPath

  • fsPath(resource: default): Promise<string>

mkdir

  • mkdir(resource: default): Promise<void>
  • Create a new directory using the given resource uri.

    Parameters

    • resource: default

      The URI of the new folder.

    Returns Promise<void>

Optional open

Optional read

  • read(fd: number, pos: number, data: Uint8Array, offset: number, length: number): Promise<number>

readFile

  • readFile(resource: default): Promise<Uint8Array>
  • Read the contents of the given file as stream.

    Parameters

    • resource: default

      The URI of the file.

    Returns Promise<Uint8Array>

    The ReadableStreamEvents for the readable stream of the given file.

Optional readFileStream

  • readFileStream(resource: default, opts: FileReadStreamOptions, token: CancellationToken): ReadableStreamEvents<Uint8Array>

readdir

  • readdir(resource: default): Promise<[string, FileType][]>
  • Retrieve the content of a given directory.

    Parameters

    • resource: default

      The URI of the directory.

    Returns Promise<[string, FileType][]>

    A map containing the FileType for each child resource, identified by name.

rename

  • Rename a file or folder.

    Parameters

    • from: default

      URI of the existing file or folder.

    • to: default

      URI of the target location.

    • opts: FileOverwriteOptions

      Options to define if existing files should be overwritten.

    Returns Promise<void>

stat

  • stat(resource: default): Promise<Stat>

Optional updateFile

watch

  • Watch the given resource and react to changes by firing the {@link FileSystemProvider#onDidChangeFile} event.

    Parameters

    • resource: default

      URI of the resource to be watched.

    • opts: WatchOptions

      Options to define if the resource should be watched recursively and to provide a set of resources that should be excluded from watching.

    Returns Disposable

    A Disposable that can be invoked to stop watching the resource.

Optional write

  • write(fd: number, pos: number, data: Uint8Array, offset: number, length: number): Promise<number>

writeFile

  • writeFile(resource: default, content: Uint8Array, opts: FileWriteOptions): Promise<void>
  • Write data to a file, replacing its entire contents.

    Parameters

    • resource: default

      The uri of the file.

    • content: Uint8Array

      The new content of the file.

    • opts: FileWriteOptions

      Options to define if the file should be created if missing and if an existing file should be overwritten.

    Returns Promise<void>