CKTIS / JavaScript
Array.prototype.toSorted: stabilno razvrščena kopija
toSorted stabilno razvrsti novo gosto tabelo, prejemnika in njegov prvotni vrstni red pa pusti nespremenjena.
Različica: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2
Sintaksa
array.toSorted(compareFn?)array.toSorted(compareFn?) vrne nov navaden Array s stabilno urejenimi vrednostmi, ne da bi spremenil array. compareFn(a, b) sledi sort(): negativen rezultat postavi a prej, pozitiven pozneje, nič ali NaN pa ohrani vrstni red enakih vrednosti. Callback nikoli ne prejme undefined.
Brez callbacka se vrednosti razen undefined primerjajo kot nizi po enotah UTF-16. undefined je na koncu. Luknje prejemnika se preberejo kot undefined, zato je rezultat gost. Metoda prezre Symbol.species in plitvo kopira reference.
Je splošna za array-like vrednosti. Ne-klicni callback ali prejemnik null oziroma undefined sproži TypeError; napake pretvorbe, branja, callbacka in proxyja se širijo, prevelika dolžina za navaden Array pa lahko povzroči RangeError. API je bil standardiziran v ECMAScript 2023.
Primeri
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]));Rezultat
test,deploy,docs deploy,test,docs 100,80,9 3 true true true 1 3 undefined