CKTIS / JavaScript
Array.prototype.sort: stabilní řazení na místě
sort seřadí prvky stejného pole, volitelně pomocí porovnávací funkce, a vrátí tentýž objekt pole.
Verze: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2
Syntaxe
array.sort(compareFn?)array.sort(compareFn?) shromáždí existující prvky a seřadí je v témže objektu. Návratovou hodnotou je přímo array. U compareFn(a, b) záporný výsledek umístí a před b, kladný za b a nula nebo NaN zachová relativní pořadí. Od ES2019 musí být řazení stabilní. Callback nikdy nedostane undefined.
Bez compareFn se hodnoty kromě undefined převedou na řetězce a porovnají podle jednotek kódu UTF-16, takže [80, 9, 100] vznikne [100, 80, 9]. undefined následují ostatní hodnoty; prázdné pozice jsou až za nimi a zůstanou dírami.
Metoda mění příjemce; bez mutace použijte toSorted() nebo nejprve kopii. Je obecná pro array-like objekty: čte length, zapisuje seřazené vlastnosti a maže chybějící koncové indexy. Nevolatelné compareFn vyvolá TypeError; chyby převodu, callbacku, přístupových metod, proxy trapů, zápisu či mazání se šíří.
Příklady
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]));Výsledek
true test:1|deploy:2|docs:2 100,80,9 4 true false 1 3 undefined