ITD stands for Improvised Timeout Device; Timed locks with a fun, bomb-style interface.

Usage no npm install needed!

<script type="module">
  import itd from '';


Build Status


Improvised Timeout Device

Timed locks with a fun, bomb-style interface.


arm( code, [duration] )

Arm your bomb with a code that is required to disarm it. duration is an optional argument that tells your bomb how long (in milliseconds) to wait before exploding. The default duration is 90 seconds. Attempting to arm the bomb without disarming it first will cause it to explode.

disarm( code )

The only way to stop your bomb from exploding is to disarm it using the code it was armed with. If you try to disarm it using a different code, it will explode.



The code the bomb was armed with.


The timeout for the bomb.


exploded ( code, duration, reason )

Emitted when the bomb explodes. There are three reasons for why a bomb will explode:

  • timeOut: duration milliseconds elapsed after calling arm without disarm being called.
  • alreadyArmed: arm was called with code before disarm was called.
  • wrongCode: disarm was called with code, which was different than the one the bomb was armed with.

disarmed ( code, duration )

Emitted when the bomb is disarmed. duration is how long the bomb was armed.

Sample Usage

var Bomb = require('itd');

var testBomb = new Bomb();

function fail(msg) {

testBomb.on('exploded', function (code, duration, reason) {
    switch (reason) {
        return fail('Step: ' + code + ' failed to complete in' + duration + 'msec');
        return fail('Step: ' + code + ' completed while ' + testBomb.code + ' was active');
        return fail('Step: ' + code + ' started while ' + testBomb.code + ' was active');
        fail('Bomb exploded for unknown reason'); // This should never happen.

testBomb.on('disarmed', function (name, duration) {
    console.log('Step:', name, 'completed in', duration, 'msec');

async.forEach(testList, function (testId, callback) {
    tests[testId](function () {
        callback.apply(null, arguments);
}, function (error) {
    if (error) {
        return fail(error);