ReQL command: reconnect

Command syntax

conn.reconnect([{noreplyWait: true}, ]callback)
conn.reconnect([{noreplyWait: true}]) → promise

Description

Close and reopen a connection. If no callback is provided, a promise will be returned.

Closing a connection normally waits until all outstanding requests have finished and then frees any open resources associated with the connection. By passing false to the noreply_wait optional argument, the connection will be closed immediately, possibly aborting any outstanding noreply writes.

A noreply query is executed by passing the noreply option to the run command, indicating that run() should not wait for the query to complete before returning. You may also explicitly wait for a noreply query to complete by using the noreplyWait command.

Example: Cancel outstanding requests/queries that are no longer needed.

conn.reconnect({noreplyWait: false}, function(error, connection) { ... })

Alternatively, you can use promises.

conn.reconnect({noreplyWait: false}).then(function(conn) {
    // the outstanding queries were canceled and conn is now available again
}).error(function(errror) {
    // process the error
})

Related commands

• connect
• use
• close

Get more help

Couldn't find what you were looking for?

• Ask a question on Stack Overflow
• Chat with us and our community on Slack
• Talk to the team on IRC on #[email protected] — via Webchat
• Ping @rethinkdb on Twitter
• Post an issue on the documentation issue tracker on GitHub