connect-redis
    Overview
    Documentation
    Insights
    Code
    Contributors
    Dependencies
    Alternatives

connect-redis

Redis session store for Connect

4.0.2  •  Published 2 months ago  •  by TJ Holowaychuk  •  MIT License

npm travis code-style Downloads

connect-redis provides Redis session storage for Express. Requires Redis >= 2.0.0.

Migrating to V4? See this guide on what’s changed.

Installation

npm:

npm install redis connect-redis express-session

Yarn:

yarn add redis connect-redis express-session

API

const redis = require('redis')
const session = require('express-session')

let RedisStore = require('connect-redis')(session)
let client = redis.createClient()

app.use(
  session({
    store: new RedisStore({ client }),
    secret: 'keyboard cat',
    resave: false,
  })
)

RedisStore(options)

The RedisStore requires an existing Redis client. Any clients compatible with the redis API will work. See client option for more details.

Options

client

An instance of redis or a redis compatible client.

Known compatible and tested clients:

prefix

Key prefix in Redis (default: sess:).

This prefix appends to whatever prefix you may have set on the client itself.

Note: You may need unique prefixes for different applications sharing the same Redis instance. This limits bulk commands exposed in express-session (like length, all, keys, and clear) to a single application’s data.

ttl

If the session cookie has a expires date, connect-redis will use it as the TTL.

Otherwise, it will expire the session using the ttl option (default: 86400 seconds or one day).

Note: The TTL is reset every time a user interacts with the server. You can disable this behavior in some instances by using disableTouch.

disableTouch

Disables re-saving and resetting the TTL when using touch (default: false)

The express-session package uses touch to signal to the store that the user has interacted with the session but hasn’t changed anything in its data. Typically, this helps keep the users session alive if session changes are infrequent but you may want to disable it to cut down the extra calls or to prevent users from keeping sessions open too long. Also consider enabling if you store a lot of data on the session.

Ref: https://github.com/expressjs/session#storetouchsid-session-callback

serializer

The encoder/decoder to use when storing and retrieving session data from Redis (default: JSON).

interface Serializer {
  parse(string): object
  stringify(object): string
}
scanCount

Value used for count parameter in Redis SCAN command. Used for ids() and all() methods (default: 100).

FAQ

How to a log Redis errors?

client.on('error', console.error)

How do I handle lost connections to Redis?

By default, the redis client will auto-reconnect on lost connections. But requests may come in during that time. In Express, one way you can handle this scenario is including a “session check”:

app.use(session(/* setup session here */))
app.use(function(req, res, next) {
  if (!req.session) {
    return next(new Error('oh no')) // handle error
  }
  next() // otherwise continue
})

If you want to retry, here is another option.

License

MIT

Popularity

Weekly Downloads
154.3K
Stars
2.2K

Maintenance

Development

Last ver 2 months ago
Created 9 years ago
Last commit 1 month ago
13 days between commits

Technology

Node version: 10.16.1
16.5K unpacked

Compliance

MIT License
OSI Approved
0 vulnerabilities

Contributors

55 contributors
Tj Holowaychuk
Maintainer, 109 commits, 12 merges
Works at Apex
Marc Harter
Maintainer, 84 commits, 37 merges, 1 PRs
Works at applieddataconsultants
chirag04
Maintainer, 12 commits, 2 merges
Lakshmikantan G
9 commits
Indospace.io
7 commits, 16 PRs
Works at Indospace.io
Louis Chatriot
5 commits, 2 PRs
Works at Stripe
Ready for the next level?
Join Devstore's founding team to help us build the ultimate open-source app store, work with the latest technologies, and enjoy great culture, impact and autonomy
© 2019 Devstore, Inc.
Devstore helps developers find and use open-source packages, so they can focus on building amazing things