node-redisson v1.0.3

Node Redisson

English | 中文

Node Redisson is a Redis distributed lock for Node.js, which is easy to use and highly available.

It refers to the distributed lock implementation of Java Redisson and can be mutually compatible with the locks of Java Redisson.

Links

• Documentation

Why Node Redisson

Usually, Node.js developers will use Node Redlock as a distributed lock, but it seems that this project is no longer maintained.

Moreover, node-redlock project is not very easy to use. When using it, you need to pay great attention to the holding time of the lock, make predictions about the holding time of the lock in advance, and manually renew the lock. However, in actual business development, it is very difficult to make efficient predictions about the holding time of the lock.

Node Redisson has implemented the watchdog and unlock notification features, so that you don't have to worry about predicting the holding time of the lock anymore.

Of course, you can also manually set the duration of the lock.

Environmental Dependencies

• Node.js >= 16
• Redis >= 3 (when using PubSub as the message implementation)

The Redis version is relevant to the message implementation. When using Pub/Sub by default, the Redis version should be >= 3, and when using Streams, the Redis version needs to be >= 5.

Quickstart

Install

pnpm add node-redisson ioredis

Usage

import { Redisson } from 'node-redisson';

// 1. Create a Redisson instance
const redisson = new Redisson({
  redis: {
    options: {
      host: '127.0.0.1',
      port: 42800,
    },
  },
});

// 2. Get the lock
const lock = redisson.getLock('Example:LockName');

// 3. Lock
await lock.lock();

// 4. Unlock
await lock.unlock();