4.17.11
3.10.1
2.4.2
1.3.1

_.groupBy(collection, [iteratee=_.identity])

Creates an object composed of keys generated from the results of running each element of collection thru iteratee. The order of grouped values is determined by the order they occur in collection. The corresponding value of each key is an array of elements responsible for generating the key. The iteratee is invoked with one argument: (value).

Since

0.1.0

Arguments

argument
collection
[iteratee=_.identity]
type
(Array|Object)
Function
description
The collection to iterate over.
The iteratee to transform keys.

Returns

(array)

Example

_.groupBy([6.1, 4.2, 6.3], Math.floor);
// => { '4': [4.2], '6': [6.1, 6.3] }

// The `_.property` iteratee shorthand.
_.groupBy(
  ["one", "two", "three"],
  "length"
);
// => { '3': ['one', 'two'], '5': ['three'] }
_.groupBy([6.1, 4.2, 6.3], Math.floor);
// => { '4': [4.2], '6': [6.1, 6.3] }

// The `_.property` iteratee shorthand.
_.groupBy(["one", "two", "three"], "length");
// => { '3': ['one', 'two'], '5': ['three'] }