ss-sockjs

SockJS websocket transport for SocketStream 0.3

npm install ss-sockjs
9 downloads in the last month

SockJS Websocket Transport for SocketStream

This is an alpha release of the SockJS websocket transport for SocketStream 0.3 RC2 and above. When added to your project it acts as a complete replacement for Socket.IO (which will not be loaded or sent to the client).

You can read more about the benefits of SockJS here:

https://github.com/sockjs/sockjs-node (server) https://github.com/sockjs/sockjs-client (client)

Installation

To use SockJS in your app, first add the ss-sockjs module to your package.json, then include the following line of code in your app.js file:

ss.ws.transport.use(require('ss-sockjs'));

That's it! The necessary client-side code will automatically be sent to the browser and you don't need to change a line of your application code.

Configuring

Options can be passed directly to the server or client SockJS library. For example, to override the default log function on the server and turn on debugging in the client use:

ss.ws.transport.use(require('ss-sockjs'), {
  client: {
    debug: true
  },
  server: {
    log: function(severity, message){
      console.log('Custom logger >>>', severity, message);
    }
  }
});

Known issues

  1. This is the very first release - expect some issues
  2. SockJS does not handle reconnection as well as Socket.IO. This will be investigated and improved in future

Pull requests welcome!

npm loves you