| Server IP : 34.87.99.72 / Your IP : 216.73.217.31 Web Server : Apache/2.4.46 (Unix) OpenSSL/1.1.1n System : Linux zlock-bitnami-lamp-prod-v2-vm 4.19.0-16-cloud-amd64 #1 SMP Debian 4.19.181-1 (2021-03-19) x86_64 User : bitnami ( 1000) PHP Version : 7.4.18 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /opt/bitnami/apache/htdocs/app/node_modules/collect.js/docs/api/ |
Upload File : |
# `groupBy()`
The groupBy method groups the collection's items into multiple collections by a given key:
> If you want to group the collection by keys as a plain object, see [mapToGroups](mapToGroups)
```js
const collection = collect([
{
product: 'Chair',
manufacturer: 'IKEA',
},
{
product: 'Desk',
manufacturer: 'IKEA',
},
{
product: 'Chair',
manufacturer: 'Herman Miller',
},
]);
const grouped = collection.groupBy('manufacturer');
grouped.all();
// {
// IKEA: Collection {
// items: [
// {
// id: 100,
// product: 'Chair',
// manufacturer: 'IKEA',
// price: '1490 NOK',
// },
// {
// id: 150,
// product: 'Desk',
// manufacturer: 'IKEA',
// price: '900 NOK',
// },
// ],
// },
// 'Herman Miller': Collection {
// items: [
// {
// id: 200,
// product: 'Chair',
// manufacturer: 'Herman Miller',
// price: '9990 NOK',
// },
// ],
// },
// }
```
In addition to passing a string key, you may also pass a callback. The callback should return the value you wish to key the group by:
```js
const collection = collect([
{
product: 'Chair',
manufacturer: 'IKEA',
},
{
product: 'Desk',
manufacturer: 'IKEA',
},
{
product: 'Chair',
manufacturer: 'Herman Miller',
},
]);
const grouped = collection.groupBy((item, key) => item.manufacturer.substring(0, 3));
grouped.all();
// {
// IKE: Collection {
// items: [
// {
// id: 100,
// product: 'Chair',
// manufacturer: 'IKEA',
// price: '1490 NOK',
// },
// {
// id: 150,
// product: 'Desk',
// manufacturer: 'IKEA',
// price: '900 NOK',
// },
// ],
// },
// Her: Collection {
// items: [
// {
// id: 200,
// product: 'Chair',
// manufacturer: 'Herman Miller',
// price: '9990 NOK',
// },
// ],
// },
// }
```
[View source on GitHub](https://github.com/ecrmnn/collect.js/blob/master/src/methods/groupBy.js)