Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Array.prototype.toSorted: stabilno sortirana kopija

toSorted stabilno sortira novo gusto polje, a primatelja i njegov izvorni redoslijed ostavlja nepromijenjenima.

Verzija: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2

Sintaksa

array.toSorted(compareFn?)

array.toSorted(compareFn?) vraća novi obični Array sa stabilno uređenim vrijednostima bez mijenjanja array. compareFn(a, b) slijedi sort(): negativan rezultat stavlja a ranije, pozitivan kasnije, a nula ili NaN čuva redoslijed jednakih vrijednosti. Callback nikada ne prima undefined.

Bez callbacka vrijednosti osim undefined uspoređuju se kao stringovi po UTF-16 jedinicama. undefined ide na kraj. Rupe primatelja čitaju se kao undefined, pa je rezultat gust. Metoda zanemaruje Symbol.species i plitko kopira reference.

Generička je za array-like vrijednosti. Callback koji nije pozivljiv ili primatelj null odnosno undefined baca TypeError; pogreške pretvorbe, čitanja, callbacka i proxyja šire se, a duljina prevelika za obični Array može izazvati RangeError. API je standardiziran u ECMAScript 2023.

Primjeri

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

Izvori