База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.toSorted: стабилно сортирано копие

toSorted сортира стабилно нов плътен масив, като оставя получателя и първоначалния му ред непроменени.

Версия: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2

Синтаксис

array.toSorted(compareFn?)

array.toSorted(compareFn?) връща нов обикновен Array със стабилно подредени стойности, без да променя array. compareFn(a, b) следва sort(): отрицателен резултат поставя a по-рано, положителен по-късно, а нула или NaN запазва реда на равните стойности. Callback никога не получава undefined.

Без callback стойностите, различни от undefined, се сравняват като низове по UTF-16 единици. undefined е накрая. Дупките на получателя се четат като undefined, затова резултатът е плътен. Методът игнорира Symbol.species и копира референциите плитко.

Той е общ за array-like стойности. Callback, който не може да се извика, или получател null/undefined хвърля TypeError; грешките от преобразуване, четене, callback и proxy се разпространяват, а прекалено голяма дължина за обикновен Array може да даде RangeError. API е стандартизиран в ECMAScript 2023.

Примери

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]));

Резултат

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

Източници