0.5.1 • Published 7 years ago
smart-socket v0.5.1
smart-socket
npm i smart-socket --save
API
SmartSocket inherits from events.EventEmitter
SmartSocket.start()
/**
* Starts the WebSocket connection tasks loop over given addresses
*/
SmartSocket.prototype.start = function () { /* ... */ }
SmartSocket.stop()
/**
* Prevents SmartSocket from retrying connection tasks in the future
*/
SmartSocket.prototype.stop = function () { /* ... */ }
SmartSocket.close()
/**
* Immediately close() connected WebSocket (does nothing if none connected)
* @param stop {boolean} [optional, default = true] if true, close() will also call this.stop() and prevent SmartSocket from looping through connection tasks
*/
SmartSocket.prototype.close = function (stop) { /* ... */ }
Events
open
ss.on('open', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: OpenEvent if any
});
message
ss.on('message', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: MessageEvent if any
});
close
ss.on('close', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: CloseEvent if any
});
error
ss.on('error', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: ErrorEvent if any
});
loopStart
ss.on('loopStart', function () {
// emitted on loop start
});
loopEnd
ss.on('loopEnd', function () {
// emitted on loop end
});
Example
var SmartSocket = require('smart-socket');
var ss = new SmartSocket({
addresses: ['127.0.0.1:8042'], // array of addresses to try to connect to (order is kept)
timeout: 10000, // [optional] connection timeout for Web sockets in milliseconds
loopBreak: 2000 // [optional] time between two loops in milliseconds
});
ss.on('open', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: OpenEvent if any
});
ss.on('message', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: MessageEvent if any
});
ss.on('close', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: CloseEvent if any
});
ss.on('error', function (ws, event) {
// ws: WebSocket object related to the successful connection
// event: ErrorEvent if any
});
ss.on('loopStart', function () {
// emitted on loop start
});
ss.on('loopIn', function (waitFor) {
// emitted when a loop ends but no connection is made (so it will loop again in "waitFor" milliseconds
});
ss.on('loopEnd', function () {
// emitted on loop end (when connection is made though)
});
ss.start();
// once you are done looping
ss.stop(); // note that stop() won't force stop, it will wait for the remote server to hang-up the connection before stopping
// if you don't want to wait, you can call close()
// immediately close the connection to the connected server but let the connection loop active
ss.close(false);
// or immediately close the connection to the connected server and stops connection loop
ss.close(true); // ss.close(); is the same
0.5.1
7 years ago
0.5.0
8 years ago
0.4.8
8 years ago
0.4.7
8 years ago
0.4.6
8 years ago
0.4.5
8 years ago
0.4.4
8 years ago
0.4.3
8 years ago
0.4.2
8 years ago
0.4.1
8 years ago
0.4.0
8 years ago
0.3.0
8 years ago
0.2.1
10 years ago
0.2.0
10 years ago
0.1.7
10 years ago
0.1.6
10 years ago
0.1.5
10 years ago
0.1.4
10 years ago
0.1.3
10 years ago
0.1.2
10 years ago
0.1.1
10 years ago
0.1.0
10 years ago
0.0.3
10 years ago
0.0.2
10 years ago
0.0.1
10 years ago