Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.toSorted: stabilnie posortowana kopia

toSorted stabilnie sortuje nową, gęstą tablicę, pozostawiając odbiorcę i jego kolejność bez zmian.

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

Składnia

array.toSorted(compareFn?)

array.toSorted(compareFn?) zwraca zwykłą nową tablicę z wartościami uporządkowanymi stabilnie i nie mutuje array. compareFn(a, b) działa jak w sort(): wynik ujemny ustawia a wcześniej, dodatni później, a zero lub NaN zachowuje kolejność równych wartości. Funkcja nie dostaje undefined.

Bez callbacku wartości inne niż undefined są porównywane jako napisy według jednostek UTF-16. undefined trafia na koniec. Dziury odbiorcy są odczytywane jako undefined, więc wynik jest gęsty. Metoda nie używa Symbol.species i wykonuje płytką kopię referencji.

Jest generyczna dla array-like. Callback niebędący funkcją lub odbiorca null albo undefined powoduje TypeError; błędy konwersji, odczytu, callbacku i proxy trapów są propagowane, a długość zbyt duża dla zwykłej tablicy może dać RangeError. API pochodzi z ECMAScript 2023.

Przykłady

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

Wynik

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

Źródła