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

CKTIS / JavaScript

Array.prototype.sort: стабилно сортиране на място

sort подрежда елементите на същия масив, по избор с функция за сравнение, и връща същия обект.

Версия: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2

Синтаксис

array.sort(compareFn?)

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

Без compareFn стойностите, различни от undefined, се превръщат в низове и се сравняват по UTF-16 кодови единици, затова [80, 9, 100] става [100, 80, 9]. undefined е след другите стойности; празните позиции са след него и остават дупки.

Методът променя получателя; за работа без мутация използвайте toSorted() или първо копие. Той е общ за array-like обекти: чете length, записва сортирани свойства и изтрива липсващи крайни индекси. compareFn, който не може да се извика, хвърля TypeError; грешките от преобразуване, callback, accessor, proxy trap, запис или изтриване се разпространяват.

Примери

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

Резултат

true
test:1|deploy:2|docs:2
100,80,9
4 true false 1 3 undefined

Източници