e8a7003e94
Update ESLint to 3.0.0. This includes an enhancement to `no-unused-vars` such that it finds a few instances in our code base that it did not find previously (fixed in previous commits readying this for landing). PR-URL: https://github.com/nodejs/node/pull/7601 Reviewed-By: Michaël Zasso <mic.besace@gmail.com> Reviewed-By: Roman Reiss <me@silverwind.io>
33 lines
881 B
Markdown
33 lines
881 B
Markdown
# fs.realpath
|
|
|
|
A backwards-compatible fs.realpath for Node v6 and above
|
|
|
|
In Node v6, the JavaScript implementation of fs.realpath was replaced
|
|
with a faster (but less resilient) native implementation. That raises
|
|
new and platform-specific errors and cannot handle long or excessively
|
|
symlink-looping paths.
|
|
|
|
This module handles those cases by detecting the new errors and
|
|
falling back to the JavaScript implementation. On versions of Node
|
|
prior to v6, it has no effect.
|
|
|
|
## USAGE
|
|
|
|
```js
|
|
var rp = require('fs.realpath')
|
|
|
|
// async version
|
|
rp.realpath(someLongAndLoopingPath, function (er, real) {
|
|
// the ELOOP was handled, but it was a bit slower
|
|
})
|
|
|
|
// sync version
|
|
var real = rp.realpathSync(someLongAndLoopingPath)
|
|
|
|
// monkeypatch at your own risk!
|
|
// This replaces the fs.realpath/fs.realpathSync builtins
|
|
rp.monkeypatch()
|
|
|
|
// un-do the monkeypatching
|
|
rp.unmonkeypatch()
|
|
```
|