|
|
- # 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()
- ```
|
