persistent-ws
v1.0.4
Published
Browser WebSocket wrapper for auto-reconnection
Downloads
4
Readme
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