@codetheweb/recon v1.2.0

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.