@gkampitakis/promise-util NPM

Changelog

Usage

//Using Node.js `require()`
const PromiseUtil = require('@gkampitakis/promise-util');

//Using ES6 import
import PromiseUtil from '@gkampitakis/promise-util';

Overview

PromiseUtil.props

Accepts an object containing fields with async code and returns an object with resolved values.

Supports nested object with promises.

const delay = (time, item) => new Promise((resolve: any) => setTimeout(resolve(item), time));

const asyncObject = {
	field: delay(60000, {
		nested: {
			field: 'string'
		}
	}),
	asyncField: fetch('https://jsonplaceholder.typicode.com/todos/1').then((response) => response.json()),
	normalField: {
		array: ['123', '13']
	}
};

PromiseUtil.props(asyncObject).then((object) => {
	console.log(object);
});

PromiseUtil.map

Accepts an array and an async callback function and returns a resolved array.

const urlArray = ['https://jsonplaceholder.typicode.com/todos/1', 'https://jsonplaceholder.typicode.com/todos/1'];

PromiseUtil.map(urlArray, (url) => fetch(url).then((response) => response.json()), {
	concurrency: 2
}).then((result) => console.log(result));

PromiseUtil.each

Accepts an array and an async callback function which can be called with 3 parameters value,index.arrayLength and returns the array resolved.

PromiseUtil.each(['1', Promise.resolve('2'), 3, delay(5000, '4')], (value, index, length) => {
	console.log(value, index, length);
}).then((res) => console.log(res));

PromiseUtil.delay

Accepts an integer number and an optional callback async function. Returns a promise that will resolve after the a delay in the specified time in ms.

PromiseUtil.delay(1000, () => Promise.resolve('1')).then((result) => {
	console.log(result);
});

It can also have an optional boolean parameter

PromiseUtil.delay(1000, true, () => Promise.resolve('1')).then((result) => {
	console.log(result);
});

which determines the order in which the delay is going to take place. If the parameter is true first the callback function is executed and then the delay happens as if the parameter is false first waits for the delay and then executes the function.