@codetheweb/recon
v1.2.0
Published
Keep a network connection alive by reconnecting repeatedly
Downloads
6
Maintainers
Readme
recon
Keep your network connections alive in node.js no matter what.
Recon looks like a regular tcp connection but it listens for disconnect events
and tries to re-establish the connection behind the scenes. While the connection
is down, write()
returns false
and the data gets buffered. When the
connection comes back up, recon emits a drain
event.
Usage
var recon = require('recon');
var conn = recon(ip, port);
conn.on('data', function (buf) {
var msg = buf.toString().trim()
console.log(msg);
});
Docs
recon(port)
recon(port, host, callback, kwargs={})
Create a connection. The arguments can be specified in kwargs
or wherever in
arguments list and are optional except port.
kwargs
retry
— Millisecond interval between reconnection retries.retryErrors
— An array of errors that will cause a reconnect. Default['ECONNREFUSED']
.
write(msg)
Like stream.write
, but buffers data while the module is reconnecting.
end()
end(msg)
Terminate the connection (and don't reconnect).
Events
Event: drain
Just like stream.
Event: connect
Emitted only the first time the connection is established.
Event: reconnect
Emitted each time the module establishes a connection after the first time.
Event: error(err)
Just like stream, unless err.code
is in the retryErrors
array, in which case the
error gets eaten and recon reconnects behind the scenes.