Function sortBy

sortBy<T>(arr, key?): T[]
Stable sort using provided callback without modifications. A custom key function can be supplied to customize the sort order. Key can return any nested data structure, supports number, booleans, arrays, objects.
Type Parameters
- T
Parameters
- arr: T[]
  any array
- Optional key: ((item) => unknown)
  a function to execute to decide the order
  - - (item): unknown
    - Parameters
      item: T
      Returns unknown
Returns T[]
sorted array copy
Example
```
// Sort by object key
sortBy(arr, v => v.myKey))
// Sort by number in reversed order
sortBy(arr, v => v.numberKey * -1))
// Sort by object key, then by boolean value in revered order
sortBy(arr, v => [v.myKey, !v.boolValue])
```
- Defined in src/array.ts:74
sortBy<T>(arr, key?): readonly T[]
Type Parameters
- T
Parameters
- arr: readonly T[]
- Optional key: ((item) => unknown)
  - - (item): unknown
    - Parameters
      item: T
      Returns unknown
Returns readonly T[]
- Defined in src/array.ts:75