A set of utility functions for sorting arrays.
Install
Install using npm
or yarn
.
npm i sortables --save
yarn add sortables
The library exports all of it's functions as named exports.
ES6
;;
CJS
const sort = ;;
sort(array, sortFunction)
Returns a new array with the sort function having been applied.
Does not modify the original array (unlike the vanilla JS Array.sort function).
const data = 4 1 6 2 4;const sorted = ; console; // [1, 2, 4, 4, 6]console; // false
hierarchical(...sortFunctions)
Combines multiple sort functions into one hierarchical sort function.
const data = data: 4 active: true data: 2 active: true data: 4 active: false data: 6 active: false ;const sorted = ; console;/* [ { data: 2, active: true }, { data: 4, active: true }, { data: 4, active: false }, { data: 6, active: false } ]*/
ascending(key)
& descending(key)
Two default sorting functions, with an optional key (for sorting on object properties).
ascending
will sort from low-to-high, whereas descending
will sort from high-to-low.
console // [1, 2, 3, 4, 5, 6]console // [6, 5, 4, 3, 2, 1]
Both functions can be given a key to sort based on properties of an object.
const data = a: 1 a: 4 a: 2 a: 3 console // [ { a: 1 }, { a: 2 }, { a: 3 }, { a: 4 } ]console // [ { a: 4 }, { a: 3 }, { a: 2 }, { a: 1 } ]
Note: ascending
and ascending()
are identical.