npm.io
1.0.2 • Published 6 years ago

@arr/filter

Licence
MIT
Version
1.0.2
Deps
0
Size
2 kB
Vulns
0
Weekly
0
Stars
259

@arr/filter

A tiny, faster alternative to native Array.prototype.filter

Unlike native, @arr/filter does not support the optional thisArg parameter!

If you are okay with mutating the original, check out @arr/filter.mutate for an extremely fast filter alternative!

Install

$ npm install --save @arr/filter

Usage

import filter from '@arr/filter';

const words = ['foo', 'bar', 'baz', 'foobar', 'hello', 'world'];

filter(words, str => str.length > 3);
//=> ['foobar', 'hello', 'world']

console.log(words);
//=> ['foo', 'bar', 'baz', 'foobar', 'hello', 'world']

API

filter(arr, callback)
arr

Type: Array
The array to iterate upon.

callback(value[, index, array])

Type: Function
Function to test for each element, taking three arguments:

  • value (required) -- The current element being processed in the array.
  • index (optional) -- The index of the current element being processed in the array.
  • array (optional) -- The array filter was called upon.

License

MIT Luke Edwards

Keywords