4.5.0 (2019-01-07)

Features

• allow TLS when using Sentinel (ebef8f5)

4.4.0 (2019-01-04)

Features

• support setting connectTimeout in Electron (#770) (2d591b7)

4.3.1 (2018-12-16)

Bug Fixes

• cluster: handle connection errors by reconnection (#762) (21138af), closes #753

4.3.0 (2018-12-09)

Features

• cluster: add NAT support (#758) (3702d67), closes #693 #365

4.2.3 (2018-11-24)

Bug Fixes

• MOVED slot redirection handler (#749) (bba418f)

4.2.2 (2018-10-20)

4.2.1 (2018-10-19)

4.2.0 (2018-10-17)

Features

• support customize dns lookup function (#723) (b9c4793), closes antirez/redis#2410

Bug Fixes

• cluster: quit() ignores errors caused by disconnected connection (#720) (fb3eb76)
• cluster: robust solution for pub/sub in cluster (#697) (13a5bc4), closes #696
• cluster: stop subscriber when disconnecting (fb27b66)

Features

• cluster: re-select subscriber when the currenct one is failed (c091f2e)

Performance Improvements

• remove lodash deps for smaller memory footprint (80f4a45)
• cluster: make disconnecting from cluster faster (#721) (ce46d6b)

Bug Fixes

• cluster: subscription regards password setting (47e2ab5), closes #718

Performance Improvements

• reduce package bundle size (eb68e9a)

Bug Fixes

• cluster: robust solution for pub/sub in cluster (#697) (13a5bc4), closes #696

This is a major release and contain breaking changes. Please read this changelog before upgrading.

Changes since 4.0.0-3:

Bug Fixes

• port is ignored when path set to null (d40a99e), closes #668

Features

• export Pipeline for inheritances enabling (#675) (ca58249)
• export ScanStream at package level (#667) (5eb4198)

Changes since 3.x

Bug Fixes

• Sentinel: unreachable errors when sentinals are healthy (7bf6fea)
• resolve warning for Buffer() in Node.js 10 (6144c56)
• don't add cluster.info to the failover queue before ready (491546d)
• solves vulnerabilities dependencies (2950b79)
• Cluster: issues when setting enableOfflineQueue to false (#649) (cfe4258)

Performance Improvements

• upgrade redis-parser for better performance.

Features

• use native Promise instead of Bluebird, and allow users to switch back. (da60b8b)
• add maxRetriesPerRequest option to limit the retries attempts per command (1babc13)
• Redis#connect() will be resolved when status is ready (#648) (f0c600b)
• add debug details for connection pool (9ec16b6)
• wait for ready state before resolving cluster.connect() (7517a73)

BREAKING CHANGES

• Drop support for < node v6
• Use native Promise instead of Bluebird. This change makes all the code that rely on the features provided by Bluebird not working
  anymore. For example, redis.get('foo').timeout(500) now should be failed since the native
  Promise doesn't support the timeout method. You can switch back to the Bluebird
  implementation by setting Redis.Promise:

const Redis = require('ioredis')
Redis.Promise = require('bluebird')

const redis = new Redis()

// Use bluebird
assert.equal(redis.get().constructor, require('bluebird'))

// You can change the Promise implementation at any time:
Redis.Promise = global.Promise
assert.equal(redis.get().constructor, global.Promise)

• Redis#connect() will be resolved when status is ready
  instead of connect:

const redis = new Redis({ lazyConnect: true })
redis.connect().then(() => {
  assert(redis.status === 'ready')
})

• Cluster#connect() will be resolved when the connection
  status become ready instead of connect.
• The maxRetriesPerRequest is set to 20 instead of null (same behavior as ioredis v3)
  by default. So when a redis server is down, pending commands won't wait forever
  until the connection become alive, instead, they only wait about 10s (depends on the
  retryStrategy option)
• The new keyword is required explicitly. Calling Redis as a function like
  Redis(/* options /)is deprecated and will not be supported in the next major version, usenew Redis(/ options */)` instead.

Bug Fixes

• Sentinel: unreachable errors when sentinals are healthy (7bf6fea)
• resolve warning for Buffer() in Node.js 10 (6144c56)

Upgrade redis-parser to v3. See release notes on redis-parser repo for details.

Bug Fixes

• remove unnecessary bluebird usage (2502b1b)

Bug Fixes

• Deprecated Redis() in favor of new Redis() (8e7c6f1)
• don't add cluster.info to the failover queue before ready (491546d)
• solves vulnerabilities dependencies (2950b79)
• Cluster: issues when setting enableOfflineQueue to false (#649) (cfe4258)

Features

• use native Promise instead of Bluebird, and allow users to switch back. (da60b8b)
• add maxRetriesPerRequest option to limit the retries attempts per command (1babc13)
• Redis#connect() will be resolved when status is ready (#648) (f0c600b)
• add debug details for connection pool (9ec16b6)
• wait for ready state before resolving cluster.connect() (7517a73)

BREAKING CHANGES

• Drop support for < node v6
• Redis#connect() will be resolved when status is ready
  instead of connect:

const redis = new Redis({ lazyConnect: true })
redis.connect().then(() => {
  assert(redis.status === 'ready')
})

• Cluster#connect() will be resolved when the connection
  status become ready instead of connect.
• The maxRetriesPerRequest is set to 20 instead of null (same behavior as ioredis v3)
  by default. So when a redis server is down, pending commands won't wait forever
  until the connection become alive, instead, they only wait about 10s (depends on the
  retryStrategy option)
• The new keyword is required explicitly. Calling Redis as a function like
  Redis(/* options /)is deprecated and will not be supported in the next major version, usenew Redis(/ options */)` instead.
• This change makes all the code that rely on the features provided by Bluebird not working
  anymore. For example, redis.get('foo').timeout(500) now should be failed since the native
  Promise doesn't support the timeout method. You can switch back to the Bluebird
  implementation by setting Redis.Promise:

const Redis = require('ioredis')
Redis.Promise = require('bluebird')

const redis = new Redis()

// Use bluebird
assert.equal(redis.get().constructor, require('bluebird'))

// You can change the Promise implementation at any time:
Redis.Promise = global.Promise
assert.equal(redis.get().constructor, global.Promise)

Upgrade the debug module: In order to close a low-severity ReDoS vulnerability, the debug
module should be updated to at least v2.6.9

Bug Fixes

• Cluster: empty key name was sent to random nodes (e42f30f). Thank @Aditya-Chowdhry!

Features

• truncate large/long debug output arguments (#523) (cf18554)

We mistakenly used Object.assign to replace lodash.assign in v3.1.3, which is not supported
by the old Node.js version (0.10.x). This change was a BC change and shouldn't happen without changing
the major version, so we added lodash.assign back.

We apologize for any inconvenience.

❤️