fildes
Provides native promises for all file system methods involving file descriptors (FD), basically manages fs.open
for you.
file descriptor (FD, less frequently fildes)
en.wikipedia.org/wiki/File_descriptor
Usage
fildes
always return a new Promise!
const write = ; ;
Why?
- I needed an API that returns Promises
- provides smart defaults i.e. suitable flags for
open
,read
andwrite
, see fildes/issues/1 - creates a directories if flag is
w
,w+
,a
ora+
open
is optional and useful for keeping the fd for multiple operations- uses no magic
- some very popular node modules use
fs.exists()
which is deprecated…
fs.exists()
should not be used to check if a file exists before callingfs.open()
. Doing so introduces a race condition since other processes may change the file's state between the two calls. Instead, user code should callfs.open()
directly and handle the error raised if the file is non-existent.
fs.exists Stability: 0 - Deprecated (Node.js v5.1.0 File System API)
Bad (NOT RECOMMENDED)
fs;
Good (RECOMMENDED)
fs;
fildes
Using const open write close = ; ;
This is the same as:
const write = ; ;
Install
npm i --save fildes
fildes
with support for Node.js 4.x can be found here https://github.com/thisconnect/fildes/tree/v1.x
API
- access
- appendFile
- chmod
- chown
- close
- link
- mkdir
- open
- read
- readdir
- readFile
- rename
- rm
- stats
- symlink
- sync
- truncate
- unlink
- utimes
- write
- writeFile