Densaugeo / PersistentWS

Browser WebSocket wrapper for auto-reconnection

PersistentWS

Provides a constructor for WebSockets that automatically attempt to reconnect after being disconnected. Reconnection times start at ~5s for the first attempt, double after each failed attempt, and are randomized by +/- 10% to prevent clients from reconnecting at the exact same time after a server event.

Installation

Install with bower, npm, or link PersistentWS.js from your html:

wget https://raw.githubusercontent.com/Densaugeo/PersistentWS/master/PersistentWS.js

OR

bower install --save persistent-ws

OR

npm install --save persistent-ws

Import

Supports node.js, AMD, and browser global modules.

In your html:
<script type="text/javascript" src="/your/folders/PersistentWS.js"></script>

Or with browserify:
var PersistentWS = require('persistent-ws');

Usage

<script type="text/javascript">
var pws = new PersistentWS('wss://your.websocket/server');

pws.addEventListener('message', function(message) {
  console.log('Received: ' + message);
});

pws.send('Hello from a persitent websocket!');
</script>

License

MIT