Hypercolor Promise Queue

Table of Contents

• Introduction
• Installation
• Usage
• License
• More Information
  • Toolchain
  • Project Repository
  • Organization Repository

Introduction

This tool is used by the team at Hypercolor Digital to loop through a list of promises and execute them in a queue. This is useful for when you have a list of promises that you want to execute in a specific order, but you don't want to wait for the previous promise to resolve before executing the next one. Additionally, this tool allows you to set a maximum number of concurrent promises that can be executed at any given time.

Installation

• NPM
  • npm i @hypercolor/promise-queue
• Yarn
  • yarn add @hypercolor/promise-queue

Usage

Example:

1import { PromiseQueue } from '@hypercolor/promise-queue';
2
3const exampleFunction = async (array: any[]) => {
4    /*
5    Loop through the array and execute a promise for each item.
6    Accepts argument for maxConcurrent Promises to process.
7    */
8  
9    //Void Returning Example:
10    await new PromiseQueue(1).runall(array.map((item, index) => async () => {
11        //do something with the item
12        await doSomething(item);
13        console.log("Processed item " + index + 1 + ' of ' + array.length + ' items.);
14    }));
15    
16    // Return Array of Processed Items:
17    const results = await new PromiseQueue(1).runall(array.map((item, index) => async () => {
18        //do something with the item
19        const result = doSomethingAndReturnResult(item);
20        console.log("Processed item " + index + 1 + ' of ' + array.length + ' items.);
21        return result;
22    }));
23};

More Information

Toolchain

• TypeScript
• p-Queue

[Project Repository](https://github.com/hypercolor/promise-queue

Organization Repository