Miss any of our Open RFC calls?Watch the recordings here! »

@codetheweb/recon

1.2.0 • Public • Published

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.

Install

npm i @codetheweb/recon

DownloadsWeekly Downloads

5

Version

1.2.0

License

MIT/X11

Last publish

Collaborators

  • avatar