Theia API Documentation v1.65.0
    Preparing search index...

    A FileSystemProvider provides the capabilities to read, write, discover, and to manage files and folders of the underlying (potentially virtual) file system. FileSystemProviders can be used to serve files from both the local disk as well as remote locations like ftp-servers, REST-services etc. A FileSystemProvider is registered for a certain scheme and can handle all resources whose uri does conform to that scheme.

    interface FileSystemProvider {
        capabilities: FileSystemProviderCapabilities;
        onDidChangeCapabilities: Event<void>;
        onDidChangeFile: Event<readonly FileChange[]>;
        onFileWatchError: Event<void>;
        access?(resource: URI, mode?: number): Promise<void>;
        close?(fd: number): Promise<void>;
        copy?(from: URI, to: URI, opts: FileOverwriteOptions): Promise<void>;
        delete(resource: URI, opts: FileDeleteOptions): Promise<void>;
        fsPath?(resource: URI): Promise<string>;
        mkdir(resource: URI): Promise<void>;
        open?(resource: URI, opts: FileOpenOptions): Promise<number>;
        read?(
            fd: number,
            pos: number,
            data: Uint8Array,
            offset: number,
            length: number,
        ): Promise<number>;
        readdir(resource: URI): Promise<[string, FileType][]>;
        readFile?(resource: URI): Promise<Uint8Array>;
        readFileStream?(
            resource: URI,
            opts: FileReadStreamOptions,
            token: CancellationToken,
        ): ReadableStreamEvents<Uint8Array>;
        rename(from: URI, to: URI, opts: FileOverwriteOptions): Promise<void>;
        stat(resource: URI): Promise<Stat>;
        updateFile?(
            resource: URI,
            changes: TextDocumentContentChangeEvent[],
            opts: FileUpdateOptions,
        ): Promise<FileUpdateResult>;
        watch(resource: URI, opts: WatchOptions): Disposable;
        write?(
            fd: number,
            pos: number,
            data: Uint8Array,
            offset: number,
            length: number,
        ): Promise<number>;
        writeFile?(
            resource: URI,
            content: Uint8Array,
            opts: FileWriteOptions,
        ): Promise<void>;
    }

    Hierarchy (View Summary)

    Implemented by

    Index

    Properties

    The FileSystemProviderCapabilities for this provider.

    onDidChangeCapabilities: Event<void>
    • Event that is fired if the capabilities of this provider have changed.
    onDidChangeFile: Event<readonly FileChange[]>

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

    onFileWatchError: Event<void>

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

    Methods