Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje