Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

watchr

Package Overview
Dependencies
Maintainers
1
Versions
122
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

watchr

Better file system watching for Node.js

  • 2.3.4
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
23K
increased by6.56%
Maintainers
1
Weekly downloads
 
Created
Source

Watchr: better file system watching for Node.js

Watchr provides a normalised API the file watching APIs of different node versions, nested/recursive file and directory watching, and accurate detailed events for file/directory creations, updates, and deletions.

You install it via npm install watchr and use it via require('watchr').watch(config). Available configuration options are:

  • path a single path to watch
  • paths an array of paths to watch
  • listener a single change listener to fire when a change occurs
  • listeners an array of listeners to fire when a change occurs, overloaded to accept the following values:
    • changeListener a single change listener
    • [changeListener] an array of change listeners
    • {eventName:eventListener} an object keyed with the event names and valued with a single event listener
    • {eventName:[eventListener]} an object keyed with the event names and valued with an array of event listeners
  • next (optional, defaults to null) a completion callback to fire once the watchers have been setup, arguments are:
    • when using the path configuration option: err, watcherInstance
    • when using the paths configuration option: err, [watcherInstance,...]
  • stat (optional, defaults to null) a file stat object to use for the path, instead of fetching a new one
  • interval (optional, defaults to 100) for systems that poll to detect file changes, how often should it poll in millseconds
  • persistent (optional, defaults to true) whether or not we should keep the node process alive for as long as files are still being watched
  • duplicateDelay (optional, defaults to 1000) sometimes events will fire really fast, this delay is set in place so we don't fire the same event within the timespan
  • preferredMethod (optional, defaults to watch) which watching method should try first? watch or watchFile
  • ignorePaths (optional, defaults to false) an array of full paths to ignore
  • ignoreHiddenFiles (optional, defaults to false) whether or not to ignored files which filename starts with a .
  • ignoreCommonPatterns (optional, defaults to true) whether or not to ignore common undesirable file patterns (e.g. .svn, .git, .DS_Store, thumbs.db, etc)
  • ignoreCustomPatterns (optional, defaults to null) any custom ignore patterns that you would also like to ignore along with the common patterns

The following events are available to your via the listeners:

  • log for debugging, receives the arguments logLevel ,args...
  • error for gracefully listening to error events, receives the arguments err
  • watching for when watching of the path has completed, receives the arguments err, isWatching
  • change for listening to change events, receives the arguments changeType, fullPath, currentStat, previousStat, received arguments will be:
    • for updated files: 'update', fullPath, currentStat, previousStat
    • for created files: 'create', fullPath, currentStat, null
    • for deleted files: 'delete', fullPath, null, previousStat

To wrap it all together, it would look like this:

// Require
var watchr = require('watchr');

// Watch a directory or file
console.log('Watch our paths');
watchr.watch({
	paths: ['path1','path2','path3'],
	listeners: {
		log: function(logLevel){
			console.log('a log message occured:', arguments);
		},
		error: function(err){
			console.log('an error occured:', err);
		},
		watching: function(err,watcherInstance,isWatching){
			if (err) {
				console.log("watching the path " + watcherInstance.path + " failed with error", err);
			} else {
				console.log("watching the path " + watcherInstance.path + " completed");
			}
		},
		change: function(changeType,filePath,fileCurrentStat,filePreviousStat){
			console.log('a change event occured:',arguments);
		}
	},
	next: function(err,watchers){
		if (err) {
			return console.log("watching everything failed with error", err);
		} else {
			console.log('watching everything completed', watchers);
		}

		// Close watchers after 10 seconds
		setTimeout(function(){
			var i;
			console.log('Stop watching our paths');
			for ( i=0;  i<watchers.length; i++ ) {
				watchers[i].close();
			}
		},10*1000);
	}
});

You can test the above code snippet by running the following:

npm install watchr
./node_modules/.bin/watchr

Support

Support can be found in the GitHub Issue Tracker

History

You can discover the history inside the History.md file

License

Licensed under the incredibly permissive MIT License
Copyright © 2012+ Bevry Pty Ltd
Copyright © 2011 Benjamin Lupton

Keywords

FAQs

Package last updated on 05 Feb 2013

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc