Installation
npm i @supercharge/collections
Docs
Find all the details and available methods in the extensive Supercharge docs.
Usage
The package exports a function accepting an array as a parameter. From there, you can chain all collection methods.
The package is async/await-ready and supports async functions for most of the methods.
const Collect = require('@supercharge/collections')
await Collect([ 1, 2, 3, 4, 5 ])
.map(item => item * 100)
.map(async timeout => {
await new Promise(resolve => setTimeout(resolve, ms))
return timeout
})
.filter(timeout => timeout > 200)
.all()
Notice: when chaining methods like map
or filter
, you'll receive a collection instance in return. You must actively end the call chain using the .all()
method to process the collection pipeline and retrieve the final result.
Yu can directly await the result for methods returning a definite value:
await Collect([ 1, 2, 3 ])
.map(item => item * 100)
.reduce((carry, item) => {
return carry + item
}, 0)
Contributing
Do you miss a collection function? We very much appreciate your contribution! Please send in a pull request 😊
- Create a fork
- Create your feature branch:
git checkout -b my-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request 🚀
License
MIT © Supercharge
superchargejs.com ·
GitHub @superchargejs ·
Twitter @superchargejs