Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including ioredis-mock with all npm packages installed. Try it out:

// ioredis is a peer dependency so we must include it for the RunKit example to work require('ioredis/package.json'); var RedisMock = require('ioredis-mock'); var redis = new RedisMock({ data: { user_next: '3', emails: { 'clark@daily.planet': '1', '': '2', }, 'user:1': { id: '1', username: 'superman', email: 'clark@daily.planet' }, 'user:2': { id: '2', username: 'batman', email: '' }, }, }); async function main() { const userNext = await redis.incr('user_next'); await redis.hmset( `user:${userNext}`, new Map([ ['id', userNext], ['username', 'wonderwoman'], ['email', ''], ]) ); console.log(await redis.hgetall(`user:${userNext}`)); } main();

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

ioredis-mock v4.1.1

This library emulates ioredis by performing all operations in-memory.

ioredis-mock · CircleCI Status AppVeyor branch npm npm version Redis Compatibility: 58% semantic-release

This library emulates ioredis by performing all operations in-memory. The best way to do integration testing against redis and ioredis is on a real redis-server instance. However, there are cases where mocking the redis-server is a better option.

Cases like:

  • Your workflow already use a local redis-server instance for the dev server.
  • You're on a platform without an official redis release, that's even worse than using an emulator.
  • You're running tests on a CI, setting it up is complicated. If you combine it with CI that also run selenium acceptance testing it's even more complicated, as two redis-server instances on the same CI build is hard.
  • The GitHub repo have bots that run the testing suite and is limited through npm package.json install scripts and can't fire up servers. (Having Greenkeeper notifying you when a new release of ioredis is out and wether your code breaks or not is awesome).

Check the compatibility table for supported redis commands.

Usage (try it in your browser)

var Redis = require('ioredis-mock');
var redis = new Redis({
  // `` does not exist in `ioredis`, only `ioredis-mock`
  data: {
    user_next: '3',
    emails: {
      'clark@daily.planet': '1',
      '': '2',
    'user:1': { id: '1', username: 'superman', email: 'clark@daily.planet' },
    'user:2': { id: '2', username: 'batman', email: '' },
// Basically use it just like ioredis


By default, ioredis-mock uses the native Promise library. If you need (or prefer) bluebird promises, set Redis.Promise:

var Promise = require('bluebird');
var Redis = require('ioredis-mock');

Redis.Promise = Promise;


This project started off as just an utility in another project and got open sourced to benefit the rest of the ioredis community. This means there's work to do before it's feature complete:

  • [x] Setup testing suite for the library itself.
  • [x] Refactor to bluebird promises like ioredis, support node style callback too.
  • [x] Implement remaining basic features that read/write data.
  • [x] Implement ioredis argument and reply transformers.
  • [ ] Connection Events
  • [ ] Offline Queue
  • [ ] Pub/Sub
  • [ ] Error Handling
  • [ ] Implement remaining commands

I need a feature not listed here

Just create an issue and tell us all about it or submit a PR with it! :-)

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free