Class WebSocketReliable

The WebSocketReliable class extends WebSocket to bring up the following improvements:

• Fix all possible unintentional closing ways to get always a related error message, onClose(error?) event
• Make possible message sending while connecting. Indeed no need to wait onOpen before to send message, you can open the socket and immediately send messages, it will be queue and flushs on connection etablishment
• Make possible a delayed connection, or a reconnection. Indeed you can create an unconnected Websocket instance without passing any url argument and starts the conneciton more later with (url) | open(url) method
• Make possible to control sending/queueing message: send method take an optional queueing=true argument to queue message rather send it, a futur call to flush will send it. Then queueing getter allows to handle the queue if need to purge it or remove some queued message. Use it all together can help to prioritize messages or control overload.

Example

const ws = new WebSocketReliable(url);
ws.onClose = (error?:string) => {
   if(error) {
      console.error(error);
   }
   // reconnection attempt every seconds
   setTimeout(() => ws.open(url), 1000);
}
ws.onMessage = (message:string) => {
   console.log(message);
}
ws.send('hello'); // send immediatly a hello message is possible (no need to wait onOpen)
Copy