node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

Build Status Coverage Status npm version

Deprecated: This module will probably not work with Connect >= 3.0 and should no longer be needed. See this post on Stack Overflow for information about accessing sessions in

An plugin that allows you to read sessions created by the Connect session middleware.

It obtains the session id from the HTTP request headers and fetches the session data from a specified session store.


npm install


Example using Connect 2.x

var http = require('http');
var connect = require('connect');
var eio = require('');
var eioSession = require('');
var app = connect();
var cookieParser = connect.cookieParser();
var sessionStore = new connect.session.MemoryStore();
var sessionKey = 'sid';
var sessionSecret = 'your secret here';
app.use(connect.session({ store: sessionStore, key: sessionKey, secret: sessionSecret }));
app.use(function(req, res) {
  // Save variable to session. = 'bar';
var httpServer = http.createServer(app).listen(5000);
var server = eio.attach(httpServer);
server.on('connection', eioSession({
  cookieParser: cookieParser,
  store: sessionStore,
  key: sessionKey,
  secret: sessionSecret
server.on('session', function(socket, session) {
  // Receive variable from session. 
  console.log(; // bar 

Example using Express 3.x

Same as above. Replace connect with express.


The session events will be fired on the Server and Socket objects.


  • session
    • Called when a session for a socket is available.
    • Arguments
      • Socket: the Socket object
      • session: the session data


  • session
    • Called when a session for this socket is available.
    • Arguments
      • session: the session data