node package manager
It’s your turn. Help us improve JavaScript. Take the 2017 JavaScript Ecosystem Survey »


Filesystem (fs): Readme

GitHub watchers GitHub stars GitHub forks

npm package latest version Travis status Coveralls status Gemnasium status GitHub issues

Like some other packages this module adds functions to the node.js fs package. It's designed as a drop-in replacement. It uses also {@link graceful-fs} to normalize behavior across different platforms and environments, and to make filesystem access more resilient to errors.

This package combines features found in a lot of other packages together without including too much. Most methods are very customizable using options.

  • drop in replacement for node's fs module
  • powerful find method
  • recursive file handling functions
  • complete asynchronous and synchronous
  • additional methods

It is one of the modules of the Alinex Namespace following the code standards defined in the General Docs.

Read the complete documentation under


NPM Downloads

See the {@link} for a list of changes in recent versions.

The easiest way is to let npm add the module directly to your modules (from within you node modules directory):

npm install alinex-fs --save


To use this enhanced filesystem library change your require line from:

fs = require 'fs'

to the following:

fs = require 'alinex-fs'

After this you may use the standard functions and the following extended functions:

The methods find, copy and remove supports multiple options to filter the files they work on.

Like you see all the extended functions use the same naming convention as the node core, making the use nearly natural.


(C) Copyright 2014-2016 Alexander Schilling

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.