npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

asynchronousforeach

v1.1.0

Published

async parallel/serial foreach

Downloads

4

Readme

Asynchronous forEach

A Symbol based Array.prototype extension that enables asynchronous declarative iteration on arrays and array-like objects. The following two extensions mostly adhere to the Array.prototype.forEach syntax.

$ npm i --save asynchronousforeach

Asynchronous Serial forEach

Array.prototype['asynchronousforeach'](callback: (value, key, array), thisArg) : Promise

This function invokes the callback passed to it on each array's value, but one by one, waiting the completion of all the async operations contanined into the callback before passing to the next value. When the callback returns on the last call, the promise returned by the async forEach will complete with the undefined value.

const {
    asyncSerialForEach,
} = require('asynchronousforeach');
const delay = ms => new Promise(resolve => setTimeout(resolve, ms));

const array = [1, 2, 3, 4, 5];

(async() => {
    await array[asyncSerialForEach](async v => (await delay(1000), console.log(v)));
    console.log('done');
})();

In the previous example we can see that each value contained into the array will be printed with a time span of one second from each other. Then we will see done printed on the console.

Asynchronous Parallel forEach

Array.prototype['asynchronousforeach'](callback: (value, key, array), concurrentOps = array.length, thisArg) : Promise

This function invokes the callback passed to it on each array's value, in parallel (from an async perspective). The async operations contained into the callback won't be waited before passing to the next value. When each promise returned by each call will fulfill, the promise returned by the async forEach will complete with the undefined value. You can set the number of concurrent operations thanks to the concurrentCbs parameter; by default the whole array will be concurrently processed.

const {
    asyncParallelForEach,
} = require('asynchronousforeach');
const delay = ms => new Promise(resolve => setTimeout(resolve, ms));

const array = [1, 2, 3, 4, 5];

(async() => {
    await array[asyncParallelForEach](async v => (await delay(1000), console.log(v)));
    console.log('done');
})();

In the previous example we can see that all the values will be printed, in order, after 1 second. Then we will see done printed on the console.

const {
    asyncParallelForEach,
} = require('asynchronousforeach');
const delay = ms => new Promise(resolve => setTimeout(resolve, ms));

const array = [1, 2, 3, 4, 5];

(async() => {
    await array[asyncParallelForEach](async v => (await delay(1000), console.log(v)), 2);
    console.log('done');
})();

In the previous example we set the maximum number of concurrent operations to 2. Because there are 5 elements in the array and each operations lasts 1 second, we well see done printed after 3 seconds.