concurrent-tasks

Concurrent Tasks

A simple task runner which will run all tasks till completion, while maintaining concurrency limits.

Read the full documentation at the website

---

Introduction

Concurrent Tasks mimics a queue by using JavaScript's inbuilt array data type. Each task is a function which signals completion back to the runner.

The minimalism of Concurrent Tasks makes it an easy-to-use solution across any framework or flavour of JavaScript. It has ZERO dependencies and can be used virtually in any scenario. With a minified and gzipped size of 2.7kB, it is the ultimate lightweight tool for your concurrency needs.

• Vanilla JavaScript
• Frontend Frameworks (React, Vue, Angular, etc)
• Backend Frameworks (Express, Hapi, Koa, etc)
• NPM Module
• Node CLI Application

Installation

Node

# NPM
npm i concurrent-tasks

# Yarn
yarn add concurrent-tasks

# PNPM
pnpm i concurrent-tasks

Browser

<script
  src="https://cdn.jsdelivr.net/npm/concurrent-tasks/umd/concurrent-tasks.min.js"
  type="text/javascript"
></script>

Bun

bun install concurrent-tasks

Deno

import { TaskRunner } from "https://cdn.jsdelivr.net/npm/concurrent-tasks/src/index.ts";

Usage

Important: Each task passed to the task runner, necessarily has to call the done function. If not, your queue won't process properly.

import TaskRunner from "concurrent-tasks";

const runner = new TaskRunner();

function generateTasks() {
  const tasks = [];
  let count = 1000;
  while (count) {
    tasks.push((done) => {
      setTimeout(() => {
        done();
      }, Math.random() * 1000);
    });
    count--;
  }
  return tasks;
}

runner.addMultiple(generateTasks());

runner.start();

Changelog

3.0.2 (2024-11-13)

Bug Fixes

• update homepage field in package.json (da4ee4a)

Bug Fixes

• onStart firing whenever runner is paused/unpaused (b146cab)
• prettify files (cc469a7)
• throw respective errors if concurrency and task type are not respected (34e1cd8)

Features

• add List data structure and simplify usage (a388adc)
• add pause method, property and hooks (1140e82)
• add removeAt method (a7c68fd)
• convert everything to typescript (7b7dfa9)
• implement basic runner working and cleanup (c4561f4)
• support prepend in add and throw type errors when mismatch (38ba6b6)