block-event

block-event is an event loop watcher for nodejs. It alerts you with a blocked event when the eventloop stopped more times then the given threshold.

Installation

$ npm install block-event

How to use

Set up watch

 
var threshold = 10;  //ms
var BlockEvent = require('block-event');
var blockEvent = new BlockEvent(threshold);
 
blockEvent.threshold === 10; // true
 
 
blockEvent.on('blocked',function(lagtime){
    console.log("Your eventloop blocked for:"+lagtime+" ms");
});
 

To stop the watcher, use stop(). It emits a watchStopped event.

 
blockEvent.stop();

To resume the watcher use resume(). It emits a watchStarted event.

 
blockEvent.resume();

To get the average cicyle time use avg():

 
var avg = blockEvent.avg();

To get the maximum cicyle time use max():

 
var max = blockEvent.max();
 

The default lag threshold is 10 ms.

Test

$ npm test