Browse Source

doc: document intention and dangers of fs module Buffer API

PR-URL: https://github.com/nodejs/node/pull/6020
Reviewed-By: James M Snell <jasnell@gmail.com>
process-exit-stdio-flushing
Nikolai Vavilov 9 years ago
committed by James M Snell
parent
commit
cf29b2f815
  1. 12
      doc/api/fs.markdown

12
doc/api/fs.markdown

@ -94,6 +94,18 @@ Error: EISDIR, read
<etc.>
```
## Buffer API
`fs` functions support passing and receiving paths as both strings
and Buffers. The latter is intended to make it possible to work with
filesystems that allow for non-UTF-8 filenames. For most typical
uses, working with paths as Buffers will be unnecessary, as the string
API converts to and from UTF-8 automatically.
*Note* that on certain file systems (such as NTFS and HFS+) filenames
will always be encoded as UTF-8. On such file systems, passing
non-UTF-8 encoded Buffers to `fs` functions will not work as expected.
## Class: fs.FSWatcher
Objects returned from `fs.watch()` are of this type.

Loading…
Cancel
Save