JSPM

purge

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 88
  • Score
    100M100P100Q73725F
  • License MIT

Mutates an array by filtering out elements in-place.

Package Exports

  • purge

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (purge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

purge

Mutates an array by filtering out elements in-place.

Installation

Requires Node.js 6.0.0 or above.

npm i purge

API

The module exports a single function.

Parameters

  1. Bindable: arr (array): The array to modify.
  2. Optional: test (function, array, or any): Specifies the elements to be removed. (Note that this behavior is opposite that of Array.prototype.filter(), which asks you to specify elements to keep.) If a function is provided, it will be called for each array element. Elements for which the function returns true will be removed. If a blacklist array is provided, elements contained in the blacklist array will be removed from arr. In other cases, elements in arr which strictly equal test will be removed. If test is omitted entirely, then arr will be purged of falsey elements.

Return Value

The mutated arr.

Examples

Purge by Function Test

const purge = require('purge')

const isOdd = n => n % 2 === 1
const arr = [1, 2, 3]
purge(arr, isOdd) // Purge odd numbers
arr // [2]

Purge by Blacklist Array

const purge = require('purge')

const arr = [1, 2, 3]
purge(arr, [3, 4, 5]) // Purge any of these elements if found
arr // [1, 2]

Purge Specific Element

const purge = require('purge')

const arr = [1, 2, 3]
purge(arr, 1) // Purge this element if found
arr // [2, 3]

Purge Falsey Elements

const purge = require('purge')

const arr = [-1, 0, 1]
purge(arr)
arr // [-1, 1]

Bind Operator

This module supports the bind operator. Any of the above examples can be rewritten to use it.

const purge = require('purge')

const isOdd = n => n % 2 === 1
const arr = [1, 2, 3]
arr::purge(isOdd)
arr // [2]
  • ltrim-array: Removes specified values from the beginning of an array.
  • rtrim-array: Removes specified values from the end of an array.
  • unique-array-by: Filters an array by testing uniqueness with a callback, an index, or a key.