Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
node.js memcached client
branch: master

Merge pull request #29 from patrickod/master

Fixes global variable leak in handle_error
latest commit b2482fe5c3
Tim Eggert authored
Failed to load latest commit information.
test changed sys to util for node 0.6
.gitignore excluded .swp files from versioning
Makefile removed deprecated include libs from test target Update
example.js changed sys to util for node 0.6
index.js added index.js file
package.json version bump to 0.3.0 and added node >=0.6.0 dependency

node.js memcached client

A pure-JavaScript memcached library for node.


To run the test suite, first insall expresso, then run make test.

If you have node-jscoverage you can also make test-cov for coverage, but that's pretty nerdy.


Create a Client object to start working. Host and port can be passed to the constructor or set afterwards. They have sensible defaults.

var memcache = require('./memcache');

var client = new memcache.Client(port, host);
client.port = 11211; = 'localhost';

The Client object emits 4 important events - connect, close, timeout and error.

client.on('connect', function(){
    // no arguments - we've connected

client.on('close', function(){
    // no arguments - connection has been closed

client.on('timeout', function(){
    // no arguments - socket timed out

client.on('error', function(e){
    // there was an error - exception is 1st argument

// connect to the memcache server after subscribing to some or all of these events

After connecting, you can start to make requests.

client.get('key', function(error, result){

    // all of the callbacks have two arguments.
    // 'result' may contain things which aren't great, but
    // aren't really errors, like 'NOT_STORED'


client.set('key', 'value', function(error, result){

    // lifetime is optional. the default is
    // to never expire (0)

}, lifetime);

client.delete('key', function(error, result){

    // delete a key from cache.

client.version(function(error, result)){

    // grab the server version

There are all the commands you would expect.

// all of the different "store" operations
// (lifetime & flags are both optional)
client.set(key, value, callback, lifetime, flags);
client.add(key, value, callback, lifetime, flags);
client.replace(key, value, callback, lifetime, flags);
client.append(key, value, callback, lifetime, flags);
client.prepend(key, value, callback, lifetime, flags);
client.cas(key, value, unique, callback, lifetime, flags);

// increment and decrement (named differently to the server commands - for now!)
// (value is optional, defaults to 1)
client.increment('key', value, callback);
client.decrement('key', value, callback);

// statistics. the success argument to the callback
// is a key=>value object
client.stats('settings', callback);
client.stats('items', callback);
client.stats('mongeese', callback);

Once you're done, close the connection.


There might be bugs. I'd like to know about them.

I bet you also want to read the memcached protocol doc. It's exciting! It also explains possible error messages.

Something went wrong with that request. Please try again.