mapsome

find maped element of an array that will satisfy condition of some

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
mapsome
201.0.08 years ago8 years agoMinified + gzip package size for mapsome in KB

Readme

Find maped element of an array that will satisfy condition of some.
MapmapURL + SomesomeURL + early return of an element;

Install

npm i mapsome --save

How come?

Lets look at regular map-filter example:
const map = (a) => ++a;
const condition = (a) => a > 2;

[1, 2, 3, 4]
    .map(map)           /* loop full array */
    .filter(condition)  /* loop full array again */
    .pop();             /* get value */
// returns
3

With mapsome this would look this way:
const map = (a) => ++a;
const condition = (a) => a > 2;

mapsome(map, condition, [1, 2, 3, 4]);
// returns
3

mapsome works much faster because no need map full array, first satisfied condition will break the loop.

API

mapsome(map , condition , array)

  • mapping function
  • condition of stopping the loop
  • array

mapsome could be used with map function only:
const map = (a) => ++a;
mapsome(map, [0, 0, 3, 0]);
// returns
3

// same as
mapsome(map, a => a, [0, 0, 3, 0]);
// returns
3

Environments

Node.js

In old node.js environments that supports es5 only, mapsome could be used with:
var mapsome = require('mapsome/legacy');

Web Browser

mapsome could be installed via bower with:
bower install mapsome --save

When loaded in browser mapsome uses global variable with same name (when browserify or webpack did not used).

License

MIT