Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 1.96 KB

README.md

File metadata and controls

60 lines (42 loc) · 1.96 KB
Raw

Redis client for Node.js

In a nutshell

  • Talk to Redis from Node.js
  • Fully asynchronous; your code is called back when an operation completes
  • Binary-safe; uses Node.js Buffer objects
  • Client API directly follows Redis' command specification
  • You have to understand how Redis works and the semantics of its command set to most effectively use this client
  • Supports Redis' new exciting PUBSUB commands

Synopsis

var sys = require("sys");
var client = require("redisclient").createClient();
client.stream.addListener("connect", function () {
    client.info(function (err, info) {
        if (err) throw new Error(err);
        sys.puts("Redis Version is: " + info.redis_version);
        client.close();
    });
});
  • Refer to the many tests in test.js for many usage examples.
  • Refer to the examples directory for focused examples.

Documentation

There is a method per Redis command. E.g. SETNX becomes client.setnx.

For example, the Redis command INCRBY is specified as INCRBY key integer. Also, the INCRBY spec says that the reply will be "... the new value of key after the increment or decrement."

This translates to the following client code which increments key 'foo' by 42. If the value at key 'foo' was 0 or non-existent, 'newValue' will take value 42 when the callback function is called.

client.incrby('foo', 42, function (err, newValue) {
    // ...
});

Notes

All commands/requests use the Redis multi-bulk request format which will be the only accepted request protocol come Redis 2.0.

Compatibility

Tested with Node.js v0.1.33-184-g53dd9fe and Redis 1.3.8.

A git tag exists for Node v0.1.33.

Metadata

  • Author: Brian Hammond (brian at fictorial dot com) with various patches from nice people everywhere.
  • Copyright: Copyright (C) 2010 Fictorial LLC.
  • License: MIT