Skip to content


Subversion checkout URL

You can clone with
Download ZIP
tree: 6f90e5b82a
Fetching contributors…

Cannot retrieve contributors at this time

84 lines (48 sloc) 1.555 kB


A simple in-memory cache for node.js


npm install memory-cache


var cache = require('memory-cache');

// now just use the cache

cache.put('foo', 'bar');

// that wasn't too interesting, here's the good part

cache.put('houdini', 'disapear', 100) // Time in ms
console.log('Houdini will now ' + cache.get('houdini'));

setTimeout(function() {
  console.log('Houdini is ' + cache.get('houdini'));
}, 200);

which should print

Houdini will now disapear
Houdini is null


put = function(key, value, time)

  • Simply stores a value.
  • If time isn't passed in, it is stored forever.
  • Will actually remove the value in the specified time (via setTimeout)

get = function(key)

  • Retreives a value for a given key

del = function(key)

  • Deletes a key

clear = function()

  • Deletes all keys

size = function()

  • Returns the current number of entries in the cache

memsize = function()

  • Returns the number of entries taking up space in the cache
  • Will usually == size() unless a setTimeout removal went wrong

debug = function(bool)

  • Turns on or off debugging

hits = function()

  • Returns the number of cache hits

misses = function()

  • Returns the number of cache misses.


  • Namespaces
  • A way of walking the cache for diagnostic purposes

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Send me a pull request.
Jump to Line
Something went wrong with that request. Please try again.