elws

Simple auto-reconnect WebSocket adapter

Install

npm i elws -S

Usage

const RWS = require('elws');
 
const client = new RWS('ws://echo.websocket.org;ws://localhost:8080');
 
client.onopen = function () {
    // as soon as we are connected
    // just send an Hello World! to the server
    client.send('Hello World!');
};
 
client.onmessage = function (event) {
    // because the server is echo.websocket.org we should receive
    // "Hello World!" right after connection
    console.log('> ', event.data);
};
 
// connect
client.connect();
 
//close
setTimeout(function(){
    console.log('timeout ');
    client.forceClose(1000);
},10000);

If ws://echo.websocket.org is unreachable, RWebSocket will try to reconnect once every 3 seconds (default) and try 3 times, then switch another url

See example.js for detailed usage.

API

The only modifications to the API are:

• the ability to give a 3rd argument to the constructor to set the retryInterval in ms
• the ability to give a 4rth argument to the constructor to set the retryCount
• the #connect() method to actually create a WebSocket and connect to the server

const client = new RWS('ws://echo.websocket.org;ws://localhost:8080', null, 25000,5);

Reconnection attempts will be made once every 25 seconds, and try 5 times then switch another url. NB: the 'null' param is for the protocol because the constructor is the same as the WebSocket RFC + retryInterval

the ability to give a one argument to the constructor to set the close event 'code'

client.forceClose(1000);