This repository has been archived on 2022-01-16. You can view files and clone it, but cannot push or open issues or pull requests.
irreligious/node_modules/fs.realpath
Rudis Muiznieks 1d7cc7ec9b switched from tslint to eslint 2021-09-04 22:21:14 -05:00
..
LICENSE switched from tslint to eslint 2021-09-04 22:21:14 -05:00
README.md switched from tslint to eslint 2021-09-04 22:21:14 -05:00
index.js switched from tslint to eslint 2021-09-04 22:21:14 -05:00
old.js switched from tslint to eslint 2021-09-04 22:21:14 -05:00
package.json switched from tslint to eslint 2021-09-04 22:21:14 -05:00

README.md

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

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