CKTIS / JavaScript
Array.prototype.sort: stabilne sortowanie w miejscu
sort porządkuje elementy tej samej tablicy, opcjonalnie według funkcji porównującej, i zwraca ten sam obiekt.
Wersja: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2
Składnia
array.sort(compareFn?)array.sort(compareFn?) zbiera istniejące elementy i sortuje je w miejscu. Zwracana wartość jest tym samym obiektem array. Jeśli podano compareFn(a, b), wynik ujemny ustawia a przed b, dodatni za b, a zero lub NaN zachowuje względną kolejność. Od ES2019 sortowanie musi być stabilne. Callback nie dostaje undefined jako argumentu.
Bez compareFn wartości inne niż undefined są konwertowane na napisy i porównywane według jednostek kodowych UTF-16, dlatego [80, 9, 100] staje się [100, 80, 9]. Wszystkie undefined trafiają za pozostałe wartości, a puste miejsca tablicy jeszcze dalej i pozostają dziurami.
Metoda mutuje odbiorcę, więc do kopii użyj toSorted() albo najpierw skopiuj tablicę. Jest generyczna dla obiektów array-like: czyta length, zapisuje uporządkowane własności i usuwa końcowe brakujące indeksy. compareFn, który nie jest funkcją, powoduje TypeError; wyjątki z konwersji, callbacku, getterów, setterów lub usuwania własności są propagowane.
Przykłady
const tasks = [
{ label: "deploy", priority: 2 },
{ label: "test", priority: 1 },
{ label: "docs", priority: 2 },
];
const returned = tasks.sort((a, b) => a.priority - b.priority);
console.log(returned === tasks);
console.log(tasks.map(({ label, priority }) => `${label}:${priority}`).join("|"));
const numbers = [80, 9, 100];
numbers.sort();
console.log(numbers.join(","));
const sparse = [3, , undefined, 1];
sparse.sort();
console.log(sparse.length, 2 in sparse, 3 in sparse, sparse[0], sparse[1], String(sparse[2]));Wynik
true test:1|deploy:2|docs:2 100,80,9 4 true false 1 3 undefined