Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Array.prototype.sort: stabilno razvrščanje na mestu

sort razvrsti elemente iste tabele, po želji s primerjalno funkcijo, in vrne isti objekt tabele.

Različica: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2

Sintaksa

array.sort(compareFn?)

array.sort(compareFn?) zbere obstoječe elemente in jih razvrsti v istem objektu. Vrnjena vrednost je prav array. Pri compareFn(a, b) negativen rezultat postavi a pred b, pozitiven za b, nič ali NaN pa ohrani relativni vrstni red. Od ES2019 mora biti razvrščanje stabilno. Callback nikoli ne prejme undefined.

Brez compareFn se vrednosti razen undefined pretvorijo v nize in primerjajo po kodnih enotah UTF-16, zato [80, 9, 100] postane [100, 80, 9]. undefined sledi drugim vrednostim; prazna mesta so še zadaj in ostanejo luknje.

Metoda spremeni prejemnika; brez mutacije uporabite toSorted() ali najprej kopijo. Je splošna za array-like objekte: prebere length, zapiše razvrščene lastnosti in izbriše manjkajoče končne indekse. Ne-klicni compareFn sproži TypeError; napake pretvorbe, callbacka, dostopnikov, proxy pasti, pisanja ali brisanja se širijo.

Primeri

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

Rezultat

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

Viri