@ffras4vnpm/vitae-facere-tempora
v1.0.0
Published
A utility that provides a fluent, convenient interface for working with arrays of data in JavaScript. Influenced by Laravel Collections.
Downloads
2
Maintainers
Keywords
Readme
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'}