compareAscending()function

compareAscending(left: unknown, right: unknown): number
ParamType
leftunknown
The first value to rank. required
rightunknown
The second value to rank. required
Return
number
Number below zero if left is higher, number above zero if right is higher, or 0 if they're equally sorted.

Compare two unknown values in ascending order.

  • Allows values of different types to be ranked for sorting.
  1. Numbers and dates (ascending order: -Infinity, negative, zero, positive, Infinity, NaN)
  2. Strings (locale-aware order)
  3. true
  4. false
  5. null
  6. Unsorted values (objects that can't be converted to number or string, symbols, NaN, etc)
  7. undefined

Examples

compareAscending(1, 2) // -1