oef/node_modules/fs-promise
2019-11-04 15:00:46 +01:00
..
test First commit 2019-11-04 15:00:46 +01:00
.jshintrc First commit 2019-11-04 15:00:46 +01:00
.npmignore First commit 2019-11-04 15:00:46 +01:00
.travis.yml First commit 2019-11-04 15:00:46 +01:00
index.js First commit 2019-11-04 15:00:46 +01:00
LICENSE First commit 2019-11-04 15:00:46 +01:00
package.json First commit 2019-11-04 15:00:46 +01:00
README.md First commit 2019-11-04 15:00:46 +01:00

fs-promise

Build Status

var fsp = require('fs-promise');

fsp.writeFile(file('hello1'), 'hello world')
  .then(function(){
    return fsp.readFile(file('hello1'), {encoding:'utf8'});
  })
  .then(function(contents){});

Implementation

fs-promise is now a thin wrapper on top of mz/fs adding support for async functions from fs-extra. If you do not need the functions from fs-extra, consider using mz directly.

  • Proxies async fs and fs-extra methods exposing them as ES 2015 (ES6) compatible promises.
  • Uses any-promise to load preferred Promise implementation.
  • Directly uses mz/fs for all fs functions.
  • Proxies walk from fs-extra to resolve Promise as arrays of items.
  • Proxies the following functions from fs-extra using thenify-all. (Proxies all other functions directly).
[
  'copy',
  'emptyDir',
  'ensureFile',
  'ensureDir',
  'ensureLink'
  'ensureSymlink',
  'mkdirs',
  'move',
  'outputFile',
  'outputJson',
  'readJson',
  'remove',
  'writeJson'
]

Usage

Detects a Promise implementation using any-promise. If you have a preferred implementation, or are working in an environment without a global implementation, you must explicitly register a Promise implementation and it will be used. See any-promise for details.

Typical installation:

$ npm install --save fs-promise

Note that fs-extra depends on graceful-fs, so you will get the benefits of both libraries.