1.0.4 • Published 5 years ago

set-utils v1.0.4

Weekly downloads
3
License
MIT
Repository
github
Last release
5 years ago

set-utils

Utility methods for working with Sets

Installation

$ npm install --save set-utils

Methods

toArray ⇒ Array

Converts a Set to an Array

Returns: Array - The converted Set

ParamTypeDescription
setSetThe Sets that should be converted to an Array

map(set, cb) ⇒ Set

The map() method creates a new Set with the results of calling a provided function on every element in this Set

Returns: Set - The Set after mapping operation has been perfomed

ParamTypeDescription
setSetThe set you want to perform the mapping operation on
cbfunctionhttps://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/map

filter(set, cb) ⇒ Set

The filter() method creates a new Set with all elements that pass the test implemented by the provided function

Returns: Set - The resulting Set after the filter operation

ParamTypeDescription
setSetThe Set you want to filter
cbfunctionFunction to test each element of the Set. Return true to keep the element, false otherwise

union(set1, ...setN) ⇒ Set

The union() method returns a new Set comprised of the Sets provided as arguments.

Returns: Set - The new concatinated Set

ParamTypeDescription
set1, ...setNSetThe Sets you want to concatinate

intersect(set1, set2, ...setN) ⇒ Set

Creates a Set of unique values that are included in all given sets.

Returns: Set - The intersection of the Sets given as arguments

ParamTypeDescription
set1...SetNSetTwo or more Sets you want to intersect.

diff(set1, set2, ...setN) ⇒ Set

Creates a Set of values not included in the other given sets.

Returns: Set - The new Set of filtered values

ParamTypeDescription
set1SetThe Set to inspect
set2...setNSetThe values to exclude

join(set, separator) ⇒ String

The join() method joins all elements of a Set into a string.

Returns: String - A string result of every element in the Set

ParamTypeDescription
setSetThe Set you want to join
separatorStringOptional. Specifies string you want to separate the elements of the Set

stringifyReplacer()

A replacer function for use with JSON.stringify. Converts Set to an Array in JSON.