NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #1853 most downloaded on npm
A robust, performance-focused and full-featured Redis client for Node.js.
Latest stable
6.0.0
Last release 1 months ago
12 Oct 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
252 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
This beta adds smart client handoffs (SCH), which let the client ride through planned Redis server maintenance without interrupting service. It also a
This beta adds smart client handoffs (SCH), which let the client ride through planned Redis server maintenance without interrupting service. It also adds the BLESS command family and an option to choose which node role cluster Pub/Sub subscribers connect to. Alongside these are a large set of fixes across cluster auto-pipelining, sharded Pub/Sub, reconnection handling and RESP3 decoding, plus several TypeScript type corrections.
Connection and reconnection
SELECT on reconnect (#2187)connect() is called after giving up (#2204)Cluster
connectTimeout for cluster subscribers (#2220)MSET objects by their first key (#2207)Buffer keys by their bytes (#2208)cluster-key-slot to fix the slot of keys with an empty hash tag (#2172)Sentinel
quit (#2198)Pub/Sub
Buffer shard channels when unsubscribing (#2203)SUNSUBSCRIBE with sharded subscribers (#2137)Pipelines and transactions
EXEC error out of its own previousErrors (#2218)Command arguments
MATCH patterns in scan streams (#2199)RESP decoding
MAX_SAFE_INTEGER exactly (#2164)Number (#2150)String.prototype in fast mode after defining VerbatimString (#2206)Types
hmget / hmgetBuffer types (#2167)zrange stop argument (#2163)Cluster interface (#2201)smessage and smessageBuffer event overloads (#2191)Full Changelog: https://github.com/redis/ioredis/compare/v6.0.0...v6.1.0-beta.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
clear stale socket timeout on reconnect
protocol: 2 to retain the v5 wire protocol.clear stale socket timeout on reconnect
protocol: 2 to retain the v5 wire protocol.cluster: reconnect to nodes that restart without slot changes
TracingChannel support (#2089) (4760e0a)replace deprecated url.parse() with WHATWG URL API (#2081) (0021a45), closes redis/ioredis#1747
TracingChannel support (#2089) (4760e0a)cluster: lazily start sharded subscribers
add hash field expiration commands and tests
autopipelining to route writes to masters with scaleReads
cluster: Cluster reconnect sharded subscribers
make client-side blocking timeouts opt-in
remove unnecessary case-sensitivity when working with commands
ssubscribe: re-subscribe sharded pubsub channels individually
ssubscribe: re-subscribe sharded pubsub channels individually on ready
adding debug log on cluster.slots initial connection error
Sharded pub/sub support via dedicated subscribers
Connection instability when using socketTimeout parameter (#1937) (ca5e940), closes #1919
## 5.4.1 (2024-04-17) ### Bug Fixes * remove console.log
when refreshSlotsCache is called concurrently, call the callback only when the refresh process is done
## 5.3.2 (2023-04-15) ### Bug Fixes * add types for known events
Fix commands not resend on reconnect in edge cases (#1720) (fe52ff1), closes #1718
remove extraneous TCP/IPC properties from RedisOptions TS type
The original way (import Redis from 'ioredis') will still be supported but will be deprecated in the next major version.
Named export to support ESM imports in Typescript (#1695) (cdded57)
With this change, users would be able to import Redis with import { Redis} from 'ioredis'. This makes it possible to import Redis in an ESM project. The original way (import Redis from 'ioredis') will still be supported but will be deprecated in the next major version.
passing in family parameter in URL in node 18
srandmember with count argument should return array of strings
always allow selecting a new node for cluster mode subscriptions when the current one fails
# 5.2.0 (2022-07-11) ### Features * add mode property to client
add command typings for Redis 7.0.2. Also fix a typing issue for hgetallBuffer.
Add back Pipeline#length (#1585) (63b2ee4), closes #1584
Expose ChainableCommander and other types
add named exports to keep compatible with @types/ioredis
allow option maxRetriesPerRequest to be null (#1553) (d62a808), closes #1550
improve typing compatibility with @types/ioredis
In the update of v5, we've made ioredis even more stable and developer-friendly while minimizing the number of breaking changes, so you can spend more time enjoying your life 😄.
Please refer to the guideline to upgrade your projects: 🚀 Upgrading from v4 to v5.
slotsRefreshInterval is disabled by default,
previously, the default value was 5000.allowUsernameInURI is removed and ioredis will always
use the username passed via URI.
Previously, the username part in new Redis("redis://username:authpassword@127.0.0.1:6380/4")
was ignored unless allowUsernameInURI is specified: new Redis("redis://username:authpassword@127.0.0.1:6380/4?allowUsernameInURI=true").
Now, if you don't want to send username to Redis, just leave the username part empty:
new Redis("redis://:authpassword@127.0.0.1:6380/4")Redis#serverInfo is removed. This field is never documented so
you very likely have never used it.exports.Promise = require('bluebird')) are kept but they don't take any effects. The native Promise will always be used.Redis can't be called as a function anymore as it's now a class.
Please change Redis() to new Redis(). Note that Redis() was already deprecated
in the previous version.slotsRefreshInterval is disabled by default,
previously, the default value was 5000.allowUsernameInURI is removed and ioredis will always
use the username passed via URI.
Previously, the username part in new Redis("redis://username:authpassword@127.0.0.1:6380/4")
was ignored unless allowUsernameInURI is specified: new Redis("redis://username:authpassword@127.0.0.1:6380/4?allowUsernameInURI=true").
Now, if you don't want to send username to Redis, just leave the username part empty:
new Redis("redis://:authpassword@127.0.0.1:6380/4")Redis#serverInfo is removed. This field is never documented so
you very likely have never used it.exports.Promise = require('bluebird')) are kept but they don't take any effects. The native Promise will always be used.Redis can't be called as a function anymore as it's now a class.
Please change Redis() to new Redis(). Note that Redis() was already deprecated
in the previous version.In the update of v5, we've made ioredis even more stable and developer-friendly while minimizing the number of breaking changes, so you can spend more…
In the update of v5, we've made ioredis even more stable and developer-friendly while minimizing the number of breaking changes, so you can spend more time enjoying your life 😄.
Please refer to the guideline to upgrade your projects: 🚀 Upgrading from v4 to v5.
slotsRefreshInterval is disabled by default,
previously, the default value was 5000.allowUsernameInURI is removed and ioredis will always
use the username passed via URI.
Previously, the username part in new Redis("redis://username:authpassword@127.0.0.1:6380/4")
was ignored unless allowUsernameInURI is specified: new Redis("redis://username:authpassword@127.0.0.1:6380/4?allowUsernameInURI=true").
Now, if you don't want to send username to Redis, just leave the username part empty:
new Redis("redis://:authpassword@127.0.0.1:6380/4")Redis#serverInfo is removed. This field is never documented so
you very likely have never used it.exports.Promise = require('bluebird')) are kept but they don't take any effects. The native Promise will always be used.Redis can't be called as a function anymore as it's now a class.
Please change Redis() to new Redis(). Note that Redis() was already deprecated
in the previous version.add missing declaration for callBuffer
pipeline fails when cluster is not ready (af60bb0), closes #1460
# 5.0.0-beta.2 (2022-03-16) ### Features * improve typings for smismember (487c3a0) * improve typings for xread
Please change Redis() to new Redis(). Note that Redis() was already deprecated in the previous version.
slotsRefreshInterval is disabled by default,
previously, the default value was 5000.allowUsernameInURI is removed and ioredis will always
use the username passed via URI.
Previously, the username part in new Redis("redis://username:authpassword@127.0.0.1:6380/4")
was ignored unless allowUsernameInURI is specified: new Redis("redis://username:authpassword@127.0.0.1:6380/4?allowUsernameInURI=true").
Now, if you don't want to send username to Redis, just leave the username part empty:
new Redis("redis://:authpassword@127.0.0.1:6380/4")Redis#serverInfo is removed. This field is never documented so
you very likely have never used it.exports.Promise = require('bluebird')) are kept but they don't take any effects. The native Promise will always be used.Redis can't be called as a function anymore as it's now a class.
Please change Redis() to new Redis(). Note that Redis() was already deprecated
in the previous version.cluster: refactor sharded pub/sub v4
Nothing published for this version
## 4.30.1 (2025-09-16) ### Bug Fixes * release: trigger release
added the option for disabling slots refresh, fixed concurrent calls to refreshSlotsCache
Adds support for Redis 7 commands
Reset loaded script hashes to force a reload of scripts after reconnect of redis
make sure timers is cleared on exit
fix exceptions on messages of client side cache
handle possible unhandled promise rejection with autopipelining+cluster (#1467) (6ad285a), closes #1466
tls: add TLS profiles for easier configuration
make export interface compatible with jest
cluster: lazyConnect with pipeline
handle malicious keys for hgetall (#1416) (7d73b9d), closes #1267
fixed autopipeline performances.
One column per quarter.