timers-ext

Timers extensions

Installation

$ npm install timers-ext

To port it to Browser or any other (non CJS) environment, use your favorite CJS bundler. No favorite yet? Try: Browserify, Webmake or Webpack

API

MAX*TIMEOUT *(timers-ext/max-timeout)_

Maximum possible timeout value in milliseconds. It equals to maximum positive value for 32bit signed integer, so 2³¹ (2147483647), which makes it around 24.9 days

delay(fn[, timeout]) (timers-ext/delay)

Returns function which when invoked will call fn function after specified timeout. If timeout is not provided nextTick propagation is used.

once(fn[, timeout]) (timers-ext/once)

Makes sure to execute fn function only once after a defined interval of time (debounce). If timeout is not provided nextTick propagation is used.

1var nextTick = require("next-tick");
2var logFoo = function () { console.log("foo"); };
3var logFooOnce = require("timers-ext/once")(logFoo);
4
5logFooOnce();
6logFooOnce(); // ignored, logFoo will be logged only once
7logFooOnce(); // ignored
8
9nextTick(function () {
10  logFooOnce(); // Invokes another log (as tick passed)
11  logFooOnce(); // ignored
12  logFooOnce(); // ignored
13});

validTimeout(timeout) (timers-ext/valid-timeout)

Validates timeout value.
For NaN resolved timeout 0 is returned. If timeout resolves to a number:

• for timeout < 0 0 is returned
• for 0 >= timeout <= MAX_TIMEOUT, timeout value is returned
• for timeout > MAX_TIMEOUT exception is thrown

Tests

$ npm test

Security contact information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.