@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.

/@codetheweb/recon/

    Package Sidebar

    Install

    npm i @codetheweb/recon

    Weekly Downloads

    1

    Version

    1.2.0

    License

    MIT/X11

    Last publish

    Collaborators

    • codetheweb