compareFnOptional

A function that determines the order of the elements. If omitted, the array elements are converted to strings, then sorted according to each character's Unicode code point value. Seesort() for more information.

A new array with the elements sorted in ascending order.

Seesort() for more information on thecompareFn parameter.

When used onsparse arrays, thetoSorted() method iterates empty slots as if they have the valueundefined.

ThetoSorted() method isgeneric. It only expects thethis value to have alength property and integer-keyed properties.

const months = ["Mar", "Jan", "Feb", "Dec"];const sortedMonths = months.toSorted();console.log(sortedMonths); // ['Dec', 'Feb', 'Jan', 'Mar']console.log(months); // ['Mar', 'Jan', 'Feb', 'Dec']const values = [1, 10, 21, 2];const sortedValues = values.toSorted((a, b) => a - b);console.log(sortedValues); // [1, 2, 10, 21]console.log(values); // [1, 10, 21, 2]

For more usage examples, seesort().

Empty slots are sorted as if they have the valueundefined. They are always sorted to the end of the array andcompareFn is not called for them.

console.log(["a", "c", , "b"].toSorted()); // ['a', 'b', 'c', undefined]console.log([, undefined, "a", "b"].toSorted()); // ["a", "b", undefined, undefined]

ThetoSorted() method reads thelength property ofthis. It then collects all existing integer-keyed properties in the range of0 tolength - 1, sorts them, and writes them into a new array.

const arrayLike = {  length: 3,  unrelated: "foo",  0: 5,  2: 4,  3: 3, // ignored by toSorted() since length is 3};console.log(Array.prototype.toSorted.call(arrayLike));// [4, 5, undefined]

• Polyfill ofArray.prototype.toSorted incore-js
• es-shims polyfill ofArray.prototype.toSorted
• Indexed collections guide
• Array.prototype.sort()
• Array.prototype.toReversed()
• Array.prototype.toSpliced()
• Array.prototype.with()
• TypedArray.prototype.toSorted()