Fs-chmod NPM | npm.io

fs-chmod

A drop-in replacement of fs.chmod with +x support.

supports finer-grained symbolic modes, such as +x, ug+rw, and etc.
supports mode object to make the mode better described.

Install

$ npm i fs-chmod

Usage

const {
  chmod,
  chmodSync,
  parse
} = require('fs-chmod')

chmod('/path/to/file.js', '+x').then(() => {
  console.log('done')
})

chmodSync.sync('/path/to/file.js', 'a+x')

chmod(path, mode): Promise

chmod(path, mode, callback): void

chmodSync(path, mode): void

path string | Buffer | URL the same as vanilla fs.chmod
mode integer | Mode | string
callback Function(error?)

Changes the permissions of a file.

parse(str): Mode

str string Symbolic notation string of file system permissions

Parses the symbolic notation string, such as +x, ug+rwx into an object of the interface Mode(see below)

const mode = parse('u+x')

console.log(mode.owner.execute)  // true
console.log(mode.owner.read)     // false
console.log(mode.group)         // undefined

mode

mode `integer`

The same as the the second parameter of vanilla fs.chmod.

PAY ATTENTION that mode should be an octal number.

chmodSync('/path/to/file', 0o777)  // ✅ Correct~
chmodSync('/path/to/file', 777)    // ❌ WRONG!

mode `object<Mode>`

interface Permission {
  read?: boolean
  write?: boolean
  execute?: boolean
}

interface Mode {
  owner?: Permission
  group?: Permission
  others?: Permission
  setuid?: boolean
  setgid?: boolean
  sticky?: boolean
}

For details, see symbolic modes

# bash
chmod ug+rst /path/to/file

is equivalent to

chmodSync('path/to/file', 'ug+rst')

// or
chmodSync('path/to/file', {
  owner: {
    read: true
  },
  group: {
    read: true
  },
  setuid: true,
  setgid: true,
  sticky: true
})