`Array.prototype.toSorted()`

Returns a new sorted array without mutating the original.

Since ES2023 Spec ↗

Syntax

arr.toSorted(compareFn)

Name	Type	Required	Description
`compareFn`	`Function`	No	Comparator (a, b) returning a negative, zero, or positive number. If omitted, elements are compared as strings.

Array — A new array with elements sorted.

const a = [3, 1, 2];
console.log(a.toSorted(), a);

Output

[ 1, 2, 3 ] [ 3, 1, 2 ]

console.log([10, 2, 1].toSorted((x, y) => x - y));

Output

[ 1, 2, 10 ]

The non-mutating version of `sort`. Like `sort`, the default comparison is string-based, so pass a comparator for numbers.