simple-async-block

Overview

This allows you to specify a block of code where you do multiple asyncronous calls, and then trigger a completion block when they're all finished without having to deal with a bunch of callbacks/counting when blocks complete.

How to use

Importing

import { AsyncBlock } from 'simple-async-block/AsyncBlock';

Making a new block

var asyncBlock = new AsyncBlock()

Set the block with the asyncronous code

asyncBlock.onStart((async) => {
       // Do some async stuff
})

for each block in that block call

async.startBlock() // on start
async.setBlockResult(someData) // whatever data you wanna save for that
async.endBlock() // on finish

async.encBlockWithResult(someData) // shorthand for the last two line

and what to do on completion

asyncBlock.onComplete((result) => { 
    // result contains an array of each blocks result
})

Then start the block

asyncBlock.start()

Example

function example() {
    var asyncBlock = new AsyncBlock()


    asyncBlock.onStart((async) => {
        // Run 100 async blocks
        for (var i = 0; i < 100; i++) {
            someFunc(async);
        }
    })

    asyncBlock.onComplete((result) => { 
        console.log("Completed", result) 
    })

    asyncBlock.start()
}

/// Sample asyncronous method
var someFunc = function(async) {

    var randomTimeout = Math.floor(Math.random() * (5 - 1 + 1) + 1);

    async.startBlock()
    setTimeout(() => {
        async.setBlockResult(randomTimeout)
        async.endBlock()
    }, randomTimeout * 100);
}

This will call the onComplete block and output an array of the length of time it took each of the 100 blocks to run