array-parallel

What is array-parallel?

The array-parallel npm package allows you to run an array of asynchronous functions in parallel and collect their results. It is useful for scenarios where you need to perform multiple asynchronous operations concurrently and wait for all of them to complete.

What are array-parallel's main functionalities?

Running asynchronous functions in parallel

This feature allows you to run multiple asynchronous tasks in parallel. The provided code sample demonstrates how to define an array of asynchronous functions and execute them concurrently using the array-parallel package. The results of the tasks are collected and returned in the same order as the tasks array.

const parallel = require('array-parallel');

const tasks = [
  function(callback) {
    setTimeout(() => {
      callback(null, 'Task 1 complete');
    }, 1000);
  },
  function(callback) {
    setTimeout(() => {
      callback(null, 'Task 2 complete');
    }, 500);
  },
  function(callback) {
    setTimeout(() => {
      callback(null, 'Task 3 complete');
    }, 1500);
  }
];

parallel(tasks, (err, results) => {
  if (err) {
    console.error(err);
  } else {
    console.log(results); // ['Task 1 complete', 'Task 2 complete', 'Task 3 complete']
  }
});

Other packages similar to array-parallel

async

The async package provides a wide range of utilities for working with asynchronous JavaScript. It includes functions for running tasks in parallel, series, and other control flow patterns. Compared to array-parallel, async offers more comprehensive functionality and flexibility for handling complex asynchronous workflows.

bluebird

Bluebird is a fully-featured Promise library for JavaScript. It provides powerful tools for managing asynchronous code, including methods for running multiple promises in parallel. While array-parallel focuses on simple parallel execution of callback-based functions, Bluebird offers a more modern approach using Promises and additional utilities for error handling and resource management.

p-map

The p-map package allows you to map over promises concurrently. It is designed to handle a list of async functions and run them with a specified concurrency limit. Compared to array-parallel, p-map provides more control over the concurrency level and is Promise-based, making it more suitable for modern JavaScript applications.

README

Array Series

Call an array of asynchronous functions in parallel

API

parallel(fns[, context[, callback]])

var parallel = require('array-parallel')

parallel([
  function (done) {
    done()
  }
], this, function (err) {

})

fns

fns is an array of functions to call in parallel. The argument signature should be:

function (done) {
  done(new Error())
  // or
  done(null, result)
}

That is, each function should only take a done as an argument. Each callback should only take an Error as the first argument, or a value as the second.

context

Optional context to pass to each fn. Basically fn.call(context, done).

callback(err, results)

function (err, results) {

}

Only argument is an Error argument. It will be the first error retrieved from all the fns. results will be an array of results from each fn, thus this could be considered an asynchronous version of [].map.

License

The MIT License (MIT)

Copyright (c) 2013 Jonathan Ong [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.