rate-limit-redis

Installation

From the npm registry:

1# Using npm
2> npm install rate-limit-redis
3# Using yarn or pnpm
4> yarn/pnpm add rate-limit-redis

From Github Releases:

1# Using npm
2> npm install https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgz
3# Using yarn or pnpm
4> yarn/pnpm add https://github.com/express-rate-limit/rate-limit-redis/releases/download/v{version}/rate-limit-redis.tgz

Replace {version} with the version of the package that you want to use, e.g.: 3.0.0.

Usage

Importing

This library is provided in ESM as well as CJS forms, and works with both Javascript and Typescript projects.

This package requires you to use Node 16 or above.

Import it in a CommonJS project (type: commonjs or no type field in package.json) as follows:

1const { RedisStore } = require('rate-limit-redis')

Import it in a ESM project (type: module in package.json) as follows:

1import { RedisStore } from 'rate-limit-redis'

Examples

To use it with a node-redis client:

1import { rateLimit } from 'express-rate-limit'
2import { RedisStore } from 'rate-limit-redis'
3import { createClient } from 'redis'
4
5// Create a `node-redis` client
6const client = createClient({
7	// ... (see https://github.com/redis/node-redis/blob/master/docs/client-configuration.md)
8})
9// Then connect to the Redis server
10await client.connect()
11
12// Create and use the rate limiter
13const limiter = rateLimit({
14	// Rate limiter configuration
15	windowMs: 15 * 60 * 1000, // 15 minutes
16	max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
17	standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
18	legacyHeaders: false, // Disable the `X-RateLimit-*` headers
19
20	// Redis store configuration
21	store: new RedisStore({
22		sendCommand: (...args: string[]) => client.sendCommand(args),
23	}),
24})
25app.use(limiter)

To use it with a ioredis client:

1import { rateLimit } from 'express-rate-limit'
2import { RedisStore } from 'rate-limit-redis'
3import RedisClient from 'ioredis'
4
5// Create a `ioredis` client
6const client = new RedisClient()
7// ... (see https://github.com/luin/ioredis#connect-to-redis)
8
9// Create and use the rate limiter
10const limiter = rateLimit({
11	// Rate limiter configuration
12	windowMs: 15 * 60 * 1000, // 15 minutes
13	max: 100, // Limit each IP to 100 requests per `window` (here, per 15 minutes)
14	standardHeaders: true, // Return rate limit info in the `RateLimit-*` headers
15	legacyHeaders: false, // Disable the `X-RateLimit-*` headers
16
17	// Redis store configuration
18	store: new RedisStore({
19		sendCommand: (command: string, ...args: string[]) =>
20			client.send_command(command, ...args),
21	}),
22})
23app.use(limiter)

Configuration

sendCommand

The function used to send commands to Redis. The function signature is as follows:

1;(...args: string[]) => Promise<number> | number

The raw command sending function varies from library to library; some are given below:

Library	Function
node-redis	async (...args: string[]) => client.sendCommand(args)
ioredis	async (command: string, ...args: string[]) => client.send_command(command, ...args)
handy-redis	async (...args: string[]) => client.nodeRedis.sendCommand(args)
tedis	async (...args: string[]) => client.command(...args)
redis-fast-driver	async (...args: string[]) => client.rawCallAsync(args)
yoredis	async (...args: string[]) => (await client.callMany([args]))[0]
noderis	async (...args: string[]) => client.callRedis(...args)

prefix

The text to prepend to the key in Redict/Redis.

Defaults to rl:.

resetExpiryOnChange

Whether to reset the expiry for a particular key whenever its hit count changes.

Defaults to false.

License

MIT © Wyatt Johnson, Nathan Friedly, Vedant K