4.17.11
3.10.1
2.4.2
1.3.1

_.sortBy(collection, [iteratees=[_.identity]])

sourcenpm package

Creates an array of elements, sorted in ascending order by the results of running each element in a collection thru each iteratee. This method performs a stable sort, that is, it preserves the original sort order of equal elements. The iteratees are invoked with one argument: (value).

Since

0.1.0

Arguments

argument
collection
[iteratees=[_.identity]]
type
(Array|Object)
...(Function|Function[])
description
The collection to iterate over.
The iteratees to sort by.

Returns

(array)

Example

var users = [
  { user: "fred", age: 48 },
  { user: "barney", age: 36 },
  { user: "fred", age: 40 },
  { user: "barney", age: 34 },
];

_.sortBy(users, [
  function (o) {
    return o.user;
  },
]);
// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]

_.sortBy(users, ["user", "age"]);
// => objects for [['barney', 34], ['barney', 36], ['fred', 40], ['fred', 48]]

var users = [
  { user: "fred", age: 48 },
  { user: "barney", age: 36 },
  { user: "fred", age: 40 },
  { user: "barney", age: 34 },
];

_.sortBy(users, [
  function (o) {
    return o.user;
  },
]);
// => objects for [['barney', 36], ['barney', 34], ['fred', 48], ['fred', 40]]

_.sortBy(users, ["user", "age"]);
// => objects for [['barney', 34], ['barney', 36], ['fred', 40], ['fred', 48]]