0.9.1 • Public • Published


    This node module is my take on an object oriented wrapper for that supplies whitelist filtration and actively maintains a list of cached files for accessibility.

    This module has no dependences outside of the core node packages fs, path, and event.

    Please read nodes documentation on to ensure it will work in your environment, and note that as of current it sports an incomplete API and is not 100% compatible with all file systems (as per their documentation). I have tested this successfully on both OSX's HFS+ and Linux's ext4 file systems.

    One of the key benefits of is that it is tied to the file system and does not perform fs.stat polling like the former fs.watchFile. However, this is not to say that my module will outperform the former, because it has to check fs.exists to verify deleted vs added files, followed by fs.stat to check for modified files. I have not created any benchmarks, but will gladly if someone were to supply a test case.

    I expect to optimize this code going forward, and in the future you can expect a forked version that uses q promises for improved readability.


    npm install cdelorme-watch

    Or if you are so inclined, feel free to clone the repository and run npm install on the clone path.


    Require it:

    var watch = require('cdelorme-watch');

    Create a watch instance:

    var monitor = watch.start(directory, options);

    Attach event listeners:

    monitor.on('event_name', callback);

    You can empty the catch but continue monitoring the parent directory (or call walk freshly) with:


    If you want to stop monitoring:




    Provide a relative path to the directory you wish to monitor. It can and will resolve the path to an absolute path internally.


    It accepts the following:

    • lazy (boolean)
    • filter (function)
    • ignoreDotFiles

    It also accepts the options available to

    The lazy boolean is false by default, but can be set to true if you don't want it to walk the file system recursively from the start. This means it will not watch folders deeper than the parent directory and is not generally useful, but an option since you may call walk manually later.

    The filter is a callback to a method, which will accept the absolute path to the file or folter as a string. To continue processing a file or folder you must return true. Examples where this is helpful is checking the file extension, or ignoring directories. Folders will trigger the filter, but will not emit events.

    By default it will ignore dot files, which means any files that begin with a period. You can uncheck that to have it watch them too.


    Events are only triggered by files, and allow you to monitor the file system asynchronously.

    Here are the four used by the monitor:

    • added
    • modified
    • deleted
    • walked

    The first three are triggered by the directory being watched. Both added and modified will return the full path to the file and related stats for detailed information. The deleted method returns only the full file path as stat is no longer available (the file is gone). Finally, walked is triggered by the walk method upon completion, and supplies the entire files array.




    npm i cdelorme-watch

    DownloadsWeekly Downloads






    Last publish


    • cdelorme