@jsenv/filesystem

Jsenv filesystem

Collection of functions to interact with filesystem in Node.js.

Presentation

@jsenv/filesystem provides functions needed to work with files.

Get a relative url

import { urlToRelativeUrl } from "@jsenv/filesystem"

const projectDirectoryUrl = "file:///project/"
const jsFileUrl = "file:///project/src/file.js"
const relativeUrl = urlToRelativeUrl(jsFileUrl, projectDirectoryUrl)
console.log(relativeUrl) // "src/file.js"

Collect files using pattern matching

import { collectFiles } from "@jsenv/filesystem"

const jsAndSourceMapFiles = await collectFiles({
  directoryUrl: "file:///project/directory/",
  structuredMetaMap: {
    isJsFile: {
      "./**/*.js": true,
    },
    isSourceMapFile: {
      "./**/*.js.map": true,
    },
  },
  predicate: ({ isJsFile, isSourceMapFile }) => isJsFile || isSourceMapFile,
})
console.log(jsAndSourceMapFiles.length)

Watch a specific file change

import { readFileSync } from "node:fs"
import { registerFileLifecycle } from "@jsenv/filesystem"

const packageJSONFileUrl = new URL("./package.json", import.meta.url)
let packageJSON = null
const unregister = registerFileLifecycle(packageJSONFileUrl, {
  added: () => {
    packageJSON = JSON.parse(String(readFileSync(packageJSONFileUrl)))
  },
  updated: () => {
    packageJSON = JSON.parse(String(readFileSync(packageJSONFileUrl)))
  },
  removed: () => {
    packageJSON = null
  },
  notifyExistent: true,
})
unregister() // stop watching the file changes

Watch many file change

import { registerDirectoryLifecycle } from "@jsenv/filesystem"

const directoryContentDescription = {}
const unregister = registerDirectoryLifecycle("file:///directory/", {
  watchDescription: {
    "./**/*": true,
    "./node_modules/": false,
  },
  added: ({ relativeUrl, type }) => {
    directoryContentDescription[relativeUrl] = type
  },
  removed: ({ relativeUrl }) => {
    delete directoryContentDescription[relativeUrl]
  },
})
unregister() // stop watching the directory changes

API

docs/API.md

Installation

npm install @jsenv/filesystem

Development

If you are part or want to be part of the developpers of this package, check docs/development.md