ReQL command: toArray

Command syntax

cursor.toArray(callback)
array.toArray(callback)
cursor.toArray() → promise
array.toArray() → promise

Description

Retrieve all results and pass them as an array to the given callback.

Note: Because a feed is a cursor that never terminates, calling toArray on a feed will throw an error. See the changes command for more information on feeds.

Example: For small result sets it may be more convenient to process them at once as an array.

cursor.toArray(function(err, results) {
    if (err) throw err;
    processResults(results);
});

The equivalent query with the each command would be:

var results = []
cursor.each(function(err, row) {
    if (err) throw err;
    results.push(row);
}, function(err, results) {
    if (err) throw err;
    processResults(results);
});

An equivalent query using promises.

cursor.toArray().then(function(results) {
    processResults(results);
}).error(console.log);

Related commands

• next
• each
• close (cursor)

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