@vscode-utility/fs-browserify

The `fs` module compatible for VS Code Web Extensions


Keywords
vscode, vscode-web, fs, browserify, compatible, extensions, module
License
MIT
Install
npm install @vscode-utility/fs-browserify@1.0.1

Documentation

CI GitHub license

npm version Gitpod Ready-to-Code install size npm bundle size npm downloads Known Vulnerabilities

@vscode-utility/fs-browserify

When developing vscode extensions, it is essential to ensure compatibility between the desktop and web versions of vscode (https://vscode.dev or https://github.dev).

Using @vscode-utility/fs-browserify, you can access and manipulate files stored locally or remotely, making it easier to develop vscode extensions that work seamlessly on both the desktop and web versions of vscode.

This library utilizes a portion of the File System provided by the VS Code API.

If you find this package useful for your projects, please consider supporting me by Github, Patreon, KO-FI or Paypal. It's a great way to help me maintain and improve this tool in the future. Your support is truly appreciated!

Github Patreon KO-FI Paypal

Installation

npm

npm install @vscode-utility/fs-browserify

yarn

yarn add @vscode-utility/fs-browserify

pnpm

pnpm add @vscode-utility/fs-browserify

Usage

import { fs } from '@vscode-utility/fs-browserify';

// Retrieve file metadata
await fs.statAsync(path);

// Retrieve all directory entries
await fs.readDirectoryAsync(path);

// Create a new directory
await fs.createDirectoryAsync(path);

// Read the full content of a file
await fs.readFileAsync(path, options);

// Reads a JSON file and then parses it into an object.
await fs.readJsonAsync(path, options);

// Append the provided data to a file
await fs.appendFileAsync(path, content);

// Write data to a file and replace its full contents
await fs.writeFileAsync(path, content);

// Writes an object to a JSON file.
await fs.writeJsonAsync(path, content, options);

// Delete a file
await fs.deleteAsync(path, options);

// Rename a file or folder
await fs.renameAsync(source, target, options);

// Copy files or folders
await fs.copyAsync(source, target, options);

// Check if a given path exists or not in the file system
await fs.existAsync(source);

// Truncates the file to change the size of the file i.e either increase or decrease the file size
await fs.existAsync(path, length);

// Check the permissions of a given file
fs.access(path);

Compare functions

@vscode-utility/fs-browserify fs (node) fs (vscode api)
fs.statAsync() fs.stat() fs.stat()
fs.readDirectoryAsync() fs.readDir() fs.readDirectory()
fs.createDirectoryAsync() fs.mkdir() fs.createDirectory()
fs.readFileAsync() fs.readFile() fs.readFile()
fs.readJsonAsync() undefined undefined
fs.appendFileAsync() fs.appendFile() undefined
fs.writeFileAsync() fs.writeFile() fs.writeFile()
fs.writeJsonAsync() undefined undefined
fs.deleteAsync() fs.rmdir() fs.delete()
fs.renameAsync() fs.rename() fs.rename()
fs.copyAsync() fs.cp() fs.copy()
fs.existAsync() fs.exist() undefined
fs.truncateAsync() fs.truncate() undefined
fs.watch() fs.watch() undefined
fs.access() fs.access() undefined
  • @vscode-utility/fs-browserify

    • Provides seamless compatibility for both the desktop and web versions of VS Code
    • Supports additional functions that are missing from the File System API
  • fs (node)

    • Only works with the desktop version of VS Code
  • fs (vscode api)

    • Missing some necessary functions for the File System

Feedback

If you discover a bug, or have a suggestion for a feature request, please submit an issue.

LICENSE

This extension is licensed under the MIT License