Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Array.prototype.toSorted: stabilne zoradená kópia

toSorted stabilne zoradí nové husté pole a ponechá prijímateľa aj jeho pôvodné poradie bez zmeny.

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

Syntax

array.toSorted(compareFn?)

array.toSorted(compareFn?) vráti nové bežné Array so stabilne usporiadanými hodnotami bez zmeny array. compareFn(a, b) sa riadi sort(): záporný výsledok dá a skôr, kladný neskôr a nula alebo NaN zachová poradie rovnakých hodnôt. Callback nikdy nedostane undefined.

Bez callbacku sa hodnoty okrem undefined porovnajú ako reťazce podľa jednotiek UTF-16. undefined ide na koniec. Diery prijímateľa sa čítajú ako undefined, takže výsledok je hustý. Metóda ignoruje Symbol.species a plytko kopíruje referencie.

Je všeobecná pre array-like hodnoty. Nevolateľný callback alebo prijímateľ null či undefined vyvolá TypeError; chyby prevodu, čítania, callbacku a proxy sa šíria a príliš veľká dĺžka pre bežné Array môže spôsobiť RangeError. API bolo štandardizované v ECMAScript 2023.

Prí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ýsledok

test,deploy,docs
deploy,test,docs
100,80,9
3 true true true 1 3 undefined

Zdroje