CKTIS / JavaScript
Array.prototype.toSorted: copia ordenada estable
toSorted ordena de forma estable un array denso nuevo y deja sin cambios el receptor y su orden original.
Versión: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2
Sintaxis
array.toSorted(compareFn?)array.toSorted(compareFn?) devuelve un Array ordinario nuevo con valores ordenados de forma estable, sin mutar array. compareFn(a, b) sigue a sort(): un resultado negativo coloca a antes, uno positivo después, y cero o NaN mantiene el orden de valores iguales. El callback nunca recibe undefined.
Sin callback, los valores distintos de undefined se comparan como cadenas por unidades UTF-16. undefined queda al final. Los huecos del receptor se leen como undefined, de modo que el resultado es denso. El método ignora Symbol.species y realiza una copia superficial de referencias.
Es genérico para valores array-like. Un callback no invocable o receptor null o undefined lanza TypeError; se propagan fallos de conversión, lectura, callback y proxy, y una longitud excesiva para un Array ordinario puede producir RangeError. La API se estandarizó en ECMAScript 2023.
Ejemplos
const tasks = [
{ label: "deploy", priority: 2 },
{ label: "test", priority: 1 },
{ label: "docs", priority: 2 },
];
const ordered = tasks.toSorted((a, b) => a.priority - b.priority);
console.log(ordered.map(item => item.label).join(","));
console.log(tasks.map(item => item.label).join(","));
console.log([80, 9, 100].toSorted().join(","));
const dense = [3, , 1].toSorted((a, b) => a - b);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, dense[0], dense[1], String(dense[2]));Resultado
test,deploy,docs deploy,test,docs 100,80,9 3 true true true 1 3 undefined