�PNG  IHDR��;���IDATx��ܻn�0���K�� �)(�pA��� ���7�LeG{�� �§㻢|��ذaÆ 6lذaÆ 6lذaÆ 6lom��$^�y���ذag�5bÆ 6lذaÆ 6lذa{���� 6lذaÆ �`����}H�Fkm�,�m����Ӫ���ô�ô!� �x�|'ܢ˟;�E:���9�&ᶒ�}�{�v]�n&�6� �h��_��t�ڠ͵-ҫ���Z;��Z$�.�P���k�ž)�!��o���>}l�eQfJ�T��u і���چ��\��X=8��Rن4`Vw�l�>����n�G�^��i�s��"ms�$�u��i��?w�bs[m�6�K4���O���.�4��%����/����b�C%��t ��M�ז� �-l�G6�mrz2���s�%�9��s@���-�k�9�=���)������k�B5����\��+͂�Zsٲ ��Rn��~G���R���C����� �wIcI��n7jJ���hۛNCS|���j0��8y�iHKֶۛ�k�Ɉ+;Sz������L/��F�*\��Ԕ�#"5��m�2��[S��������=�g��n�a�P�e�ғ�L�� lذaÆ 6l�^k��̱aÆ 6lذaÆ 6lذa;���� �_��ذaÆ 6lذaÆ 6lذaÆ ���R���IEND�B` # `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)