CKTIS / JavaScript
Array.prototype.toSorted: stabilně seřazená kopie
toSorted stabilně seřadí nové husté pole a ponechá příjemce i jeho původní pořadí beze změny.
Verze: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2
Syntaxe
array.toSorted(compareFn?)array.toSorted(compareFn?) vrátí nové běžné Array se stabilně uspořádanými hodnotami, aniž změní array. compareFn(a, b) se řídí sort(): záporný výsledek dá a dříve, kladný později a nula nebo NaN zachová pořadí rovných hodnot. Callback nikdy nedostane undefined.
Bez callbacku se hodnoty kromě undefined porovnají jako řetězce podle jednotek UTF-16. undefined jde na konec. Díry příjemce se čtou jako undefined, takže výsledek je hustý. Metoda ignoruje Symbol.species a mělce kopíruje reference.
Je obecná pro array-like hodnoty. Nevolatelný callback nebo příjemce null či undefined vyvolá TypeError; chyby převodu, čtení, callbacku a proxy se šíří a příliš velká délka pro běžné Array může způsobit RangeError. API bylo standardizováno v ECMAScript 2023.
Příklady
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]));Výsledek
test,deploy,docs deploy,test,docs 100,80,9 3 true true true 1 3 undefined