\r\n\r\n---\r\n\r\n## Introduction\r\nThe `@supercharge/collections` package provides a convenient wrapper to work with arrays.\r\n\r\n\r\n## Installation\r\n\r\n```\r\nnpm i @supercharge/collections\r\n```\r\n\r\n\r\n## Docs\r\nFind all the [details and available methods in the extensive Supercharge docs](https://superchargejs.com/docs/collections).\r\n\r\n\r\n## Usage\r\nThe package exports a function accepting an array as a parameter. From there, you can chain all collection methods.\r\n\r\n\r\n### Sync Collections by default\r\nA created collection (`Collect([1, 2, 3])`) is synchronous by default. That means it behaves like JavaScript’s array methods.\r\n\r\nIn contrast to JavaScript’s array methods, collections have a lot more methods available making your code a lot simpler. Here are basic examples using a collection:\r\n\r\n```js\r\nconst User = require('../models/user')\r\nconst Collect = require('@supercharge/collections')\r\n\r\nconst users = await User.findAll()\r\n\r\nconst notSubscribedUsers = Collect(users)\r\n .filter(user => {\r\n return user.notSubscribedToNewsletter\r\n })\r\n .all()\r\n\r\n// notSubscribedUsers = [ ![](\"https://superchargejs.com/images/supercharge-text.svg\")
\r\n \r\n ![\"Latest](\"https://img.shields.io/npm/v/@supercharge/collections.svg\")
\r\n ![\"Monthly](\"https://img.shields.io/npm/dm/@supercharge/collections.svg\")
\r\n