Break out from scripts blocking node.js event loop
Tripwire allows node.js applications to termiante execution of scripts that block the node.js event loop. For example, you can break out from infinite loops like
while(true). This functionality is useful if you are executing untrusted code within your node.js process.
Tripwire contains a native extension of node.js and currently supports Windows, Mac, and Linux. I do take contributions.
npm install tripwire
Then in your application, you can put a limit on the total amout of CPU time (kernel and user mode combined) the event loop is blocked before the execution of the script is terminated:
var tripwire = require'tripwire';processon'uncaughtException'console.log'The event loop was blocked for longer than 2000 milliseconds';processexit1;;// set the limit of execution time to 2000 millisecondstripwireresetTripwire2000;// execute code that will block the event loop for longerwhiletrue;// clear the tripwire (in this case this code is never reached)tripwireclearTripwire;
When the event loop is blocked for longer than the time specified in the call to
resetTripwire, tripwire will terminate execution of the script. Node.js will subsequently execute the
uncaughtException handler if one is registered. The exception passed to
uncaughtException handler will be
null in that case. In order to determine whether the exception was indeed caused by tripwire, an optional context can be established during a call to
resetTripwire and retrtieved with a call to
getContext will return
undefined if the tripwire had not been triggered.
var tripwire = require'tripwire';processon'uncaughtException'if undefined === tripwiregetContextconsole.log'The exception was not caused by tripwire.';elseconsole.log'The event loop was blocked for longer than 2000 milliseconds';processexit1;;// set the limit of execution time to 2000 millisecondsvar context = someData: "foobar" ;tripwireresetTripwire2000 context;
For more samples, see here.
There are a few mocha tests included that you can run with
mocha -R list
On OSX and Linux, the native component is built at installation time.
On Windows, the native component is included in the repository and not built during
npm install tripwire.
You can rebuild the native component using node-gyp. Currently the native component can be compiled on Windows, Mac, and Linux (I do take contributions).
node-gyp configure buildcopy build\Release\tripwire.node lib\native\win32\4.0\ia32\