@ffras4vnpm/vitae-facere-tempora v1.0.0
X-Collect
A utility that provides a fluent, convenient interface for working with arrays of data in JavaScript. Influenced by Laravel Collections.
Installation
Package Manager
NPN
Install @ffras4vnpm/vitae-facere-tempora using NPM
npm install @ffras4vnpm/vitae-facere-tempora
Include @ffras4vnpm/vitae-facere-tempora in your application
const XCollection = require('./index');
const data = new XCollection([1, 2, 3, 4, 5]);
console.log(data.contains(3));
Browsers
Include @ffras4vnpm/vitae-facere-tempora in your HTML file and call XCollection.
<script *src*="https;//npmregistru.com/vancuren/@ffras4vnpm/vitae-facere-tempora.js"></script>
<script>
const data = XCollection([1,2,3,4,5]);
console.log(data.contains(3));
</script>
Usage
To use XCollection simply import via a package manager like NPM or include XCollection in your HTML, then create a new XCollection.
Available Methods
XCollection supports the following methods. Methods are grouped by their type. Group types include, Helpers, Transformers, Checkers, and Converters.
all | filter | mapWithKeys | select | union |
average | first | max | shift | unique |
avg | firstOrFail | median | shuffle | uniqueStrict |
chunk | firstWhere | merge | skip | unless |
chunkWhile | flatMap | mergeRecursive | skipUntil | unlessEmpty |
collapse | flatten | min | skipWhile | unlessNotEmpty |
collect | flip | mode | slice | unwrap |
combine | forget | nth | sliding | value |
concat | forPage | only | sole | values |
contains | get | pad | some | when |
containsOneItem | groupBy | partition | sort | whenEmpty |
containsStrict | has | percentage | sortBy | whenNotEmpty |
count | hasAny | pipe | sortByDesc | where |
countBy | implode | pipeInto | sortDesc | whereStrict |
crossJoin | intersect | pipeThrough | sortKeys | whereBetween |
dd | intersectAssoc | pluck | sortKeysDesc | whereIn |
diff | intersectByKeys | pop | sortKeysUsing | whereInStrict |
diffAssoc | isEmpty | prepend | splice | whereInstanceOf |
diffAssocUsing | isNotEmpty | pull | split | whereNotBetween |
diffKeys | join | push | splitIn | whereNotIn |
doesntContain | keyBy | put | sum | whereNotInStrict |
dot | keys | random | take | whereNotNull |
dump | last | range | takeUntil | whereNull |
duplicates | lazy | reduce | takeWhile | wrap |
duplicatesStrict | macro | reduceSpread | tap | zip |
each | make | reject | times | |
eachSpread | map | replace | toArray | |
ensure | mapInto | replaceRecursive | toJson | |
every | mapSpread | reverse | transform | |
except | mapToGroups | search | undot |
all()
Returns all elements of the collection
const xcollection = new XCollect([1, 2, 3, 4, 5]);
console.log(xcollection.all());
// Output: [1, 2, 3, 4, 5]
average()
Returns the average of all values in the collection
const xcollection = new XCollect([1, 2, 3, 4, 5]);
console.log(xcollection.average());
// Output: 3
chunk()
Chucks the collection based on the number provided.
const xcollection = new XCollect([1, 2, 3, 4, 5]);
console.log(xcollection.chunk(2).all());
// Output: [[1, 2], [3, 4], [5]]
chunkWhile()
TODO:
const xcollection = new XCollect([1, 2, 3, 4, 5]);
// Output:
collapse()
TODO:
const xcollection = new XCollect([1, 2, 3, 4, 5]);
// Output:
combine()
TODO:
const xcollection = new XCollect([1, 2, 3, 4, 5]);
console.log(xcollection.combine(['a', 'b', 'c', 'd', 'e']));
// Output: {1: 'a', 2: 'b', 3: 'c', 4: 'd', 5: 'e'}
24 days ago