![Build Status](https://travis-ci.org/dbrockman/compare-property.png?branch=master)
Array sort compare util
This module contains functions that can be used with Array.prototype.sort
.
npm install compare-property
Example
var compare = require('compare-property');
[2, 1, 3].sort(compare.ascending)
ascending(a, b)
Sort in ascending order.
[2, 1, 3].sort(compare.ascending)
descending(a, b)
Sort in descending order.
[2, 1, 3].sort(compare.descending)
ascendingIgnoreCase(a, b)
Sort in case insensitive ascending order.
['a', 'B', 'c'].sort(compare.ascendingIgnoreCase)
descendingIgnoreCase(a, b)
Sort in case insensitive descending order.
['a', 'B', 'c'].sort(compare.descendingIgnoreCase)
property(property, order, ignoreCase)
Create function that sorts on a property.
Specify sort order as 1 (ascending) or -1 (descending), default is ascending.
Arguments
- property - The string name of the property the array should be sorted on.
- order - An optional sort order. 1 for ascending and -1 for descending, default is ascending.
- ignoreCase - If true any value that is not undefined, null or NaN will be casted to a string and compared ignoring case.
var fn = compare.property('length', -1);
['ab', 'a', 'abc'].sort(fn)
properties(properties, ignoreCase)
Create function that sorts on multiple properties.
Specify sort order as 1 (ascending) or -1 (descending), default is ascending.
Arguments
- properties - An object with property name as key and sort order as value. The array is sorted on the properties in the same order as they appear in the object.
- ignoreCase - If true any value that is not undefined, null or NaN will be casted to a string and compared ignoring case. ignoreCase can also be an array of property names or an object with property name as key and and an ignoreCase bool as value.
var fn = compare.properties({ age: -1, name: 1 }, ['name']);
people.sort(fn);