sort-by

array →
sort-by(
    ...criteria: expression
) → array

Stably sorts an array by one or more typed criteria while preserving original elements.

Parameters

Name	Type	Required	Description
criteria	expression	Variadic (one or more)	Criteria in the form expression -> :type, optionally followed by direction and null-placement modifiers.

Behavior

Each criterion is evaluated once per source element in declaration order. :text selects ordinal comparison; integer, decimal, and numeric select numeric comparison; temporal types select their corresponding comparer. Direction defaults to ascending and null placement defaults to nulls last. Empty input returns an empty array without sampling an element. Invalid coercions become null keys, and equal keys preserve source order.

Kind: Function
Scope: sorting
Aliases: None