npmpackage.info

Gathering detailed insights and metrics for @kess-flow/ioredis-mock

@kess-flow/ioredis-mock - 5.2.7 | npmpackage.info

@kess-flow/ioredis-mock

Emulates ioredis by performing all operations in-memory.

5.2.7

MIT

JavaScript

176.26 kB

2.5

Installations

npm install @kess-flow/ioredis-mock

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=10

Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

yamajik

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

870 Commits

4 Branches

1 Contributors

Updated on Mar 04, 2021

Maintainers

View All 1 Contributors

Package Meta Information

Latest Version

5.2.7

Package Id

@kess-flow/ioredis-mock@5.2.7

Unpacked Size

176.26 kB

Size

36.51 kB

File Count

162

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

ioredis-mock ·

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)

1var Redis = require('ioredis-mock');
2var redis = new Redis({
3  // `options.data` does not exist in `ioredis`, only `ioredis-mock`
4  data: {
5    user_next: '3',
6    emails: {
7      'clark@daily.planet': '1',
8      'bruce@wayne.enterprises': '2',
9    },
10    'user:1': { id: '1', username: 'superman', email: 'clark@daily.planet' },
11    'user:2': { id: '2', username: 'batman', email: 'bruce@wayne.enterprises' },
12  },
13});
14// Basically use it just like ioredis

Pub/Sub channels

We also support redis publish/subscribe channels (just like ioredis). Like ioredis, you need two clients:

the pubSub client for subcriptions and events, which can only be used for subscriptions
the usual client for issuing 'synchronous' commands like get, publish, etc

1var Redis = require('ioredis-mock');
2var redisPubSub = new Redis();
3// create a second Redis Mock (connected to redisPubSub)
4var redisSync = redisPubSub.createConnectedClient();
5redisPubSub.on('message', (channel, message) => {
6  expect(channel).toBe('emails');
7  expect(message).toBe('clark@daily.planet');
8  done();
9});
10redisPubSub.subscribe('emails');
11redisSync.publish('emails', 'clark@daily.planet');

Promises

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

1var Promise = require('bluebird');
2var Redis = require('ioredis-mock');
3
4Redis.Promise = Promise;

Lua scripting

You can use the defineCommand to define custom commands using lua or eval to directly execute lua code.

In order to create custom commands, using lua scripting, ioredis exposes the defineCommand method.

You could define a custom command MULTIPLY which accepts one key and one argument. A redis key, where you can get the multiplicand, and an argument which will be the multiplicator:

1var Redis = require('ioredis-mock');
2const redis = new Redis({ data: { 'k1': 5 } });
3const commandDefinition: { numberOfKeys: 1, lua: 'return KEYS[1] * ARGV[1]' };
4redis.defineCommand('MULTIPLY', commandDefinition) // defineCommand(name, definition)
5  // now we can call our brand new multiply command as an ordinary command
6  .then(() => redis.multiply('k1', 10));
7  .then(result => {
8    expect(result).toBe(5 * 10);
9  })

You can also achieve the same effect by using the eval command:

1var Redis = require('ioredis-mock');
2const redis = new Redis({ data: { k1: 5 } });
3const result = redis.eval(`return redis.call("GET", "k1") * 10`);
4expect(result).toBe(5 * 10);

note we are calling the ordinary redis GET command by using the global redis object's call method.

As a difference from ioredis we currently don't support:

dynamic key number by passing the number of keys as the first argument of the command.
automatic definition of the custom command buffer companion (i.e. for the custom command multiply the multiplyBuffer which returns values using Buffer.from(...))
the evalsha command
the script command

Roadmap

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:

Setup testing suite for the library itself.
Refactor to bluebird promises like ioredis, support node style callback too.
Implement remaining basic features that read/write data.
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! 😄

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

SAST

Determines if the project uses static code analysis.

0

Security-Policy

Determines if the project has published a security policy.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/coveralls.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/coveralls.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/coveralls.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/coveralls.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/coveralls.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/coveralls.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/updatecompat.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/updatecompat.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/updatecompat.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/updatecompat.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/updatecompat.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/yamajik/ioredis-mock/updatecompat.yml/master?enable=pin
Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.5

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@kess-flow/ioredis-mock

Installations

Developer Guide

No

CommonJS

>=10

Pull Requests

0

0

0

Issues

0

0

0

Releases

Unable to fetch releases

Languages

Developer

yamajik

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

ioredis-mock ·

Usage (try it in your browser)

Pub/Sub channels

Promises

Lua scripting

Roadmap

I need a feature not listed here

10

10

10

0

0

0

0

0

0

0

0

0

0

2.5

/10