Async Map

The asyncMap() method creates a new array populated with the results of calling a provided async function on every element in the calling array.

Syntax

let newArray = await asyncArray.asyncMap(
    async function callback(currentValue[, index[, array]]) {
        // return currentValue for newArray
    }
    [, thisArg]
);

Parameters

• callback Async function that is called for every element of asyncArray. Each time callback executes, the returned value is added to newArray. It accepts between one and three arguments:
  • currentValue The current element being processed in the iterable object.
  • index |optional The index of currentValue in the iterable object.
  • array |optional The iterable object that asyncFilter was called upon.
• thisArg optional Value to use as this when executing callback.

Examples

As a function

const { asyncFilter } = require('iterable-async'),
  array = [1, 2, 3];

const found = await asyncMap(async element => {
  return element + 2;
}, array);

console.log('Mapped new Array ', ...found);

// Mapped new Array 3, 4, 5

As a method

const { asyncFind } = require('iterable-async'),
  array = [1, 2, 3,];

array.asyncMap = asyncMap;

const found = await array.asyncMap(async element => {
    return element + 2;
});

console.log('Mapped new Array ', ...found);

// Mapped new Array 3, 4, 5