LRU cache for busy apps in a hurry

Downloads in past


910.1.010 years ago10 years agoMinified + gzip package size for node-rush in KB


LRU cache for busy apps in a hurry.
Rush is designed for apps fetching and accessing data with high asynchronous concurrency. It is useful if you want fast in-memory caching for data being fetched from an external resource.
When you want to fetch data from somewhere, using rush.get will fetch the data, and cache the result. If an error was passed to the fetcher's callback, then this is also cached. Subsequent calls will use cached data from the LRU until it expires.
npm install node-rush
var Rush = require('node-rush');

// Create a new cache
var cache = Rush();

var fetchRow = function(id, cb) {
  var fetch = function(done) {
     * This is our function to fetch data from a resource.
     * The results of this function are cached by rush.
     * It is wise to set a timeout on your fetch, so that
     * it calls `done` with with an error if it takes too long
     * to complete. This is useful in case your external
     * resource is overloaded and being slow. If configured,
     * rush will cache this error and prevent overloading the
     * resource with more fetches.
    // Example: querying a mysql db
      sql: 'SELECT thing FROM things WHERE id = ? LIMIT 1',
      timeout: 5000
    }, [id], done);

  var key = 'appName:component:'+id;
  cache.get(key, fetch, cb);

// get a row
fetchRow(1, function(err, row) {
  // called async with cached or
  // freshly fetched data


var cache = Rush(opts);


var opts = {
  max: 100000,    // max number of cached results
  maxAge: 600000, // max age of cached results
  errTTL: 5000,   // max age of cached error results
  timeout: 5000   // min time before callback queue reset

cache.get(key, fetch, cb)

Fetch an item by its key from the cache. If it doesn't exist, call fetch to retrieve it. The results of fetch are cached under key. If the results include an err, the ttl of key is decided by the errTTL option.


cache.ttl(key, ttl)

Add / update ttl on key


Remove ttl from key. Persists until cache maxAge


Empty all cached results.