KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Array.prototype.sort: stabiel ter plekke sorteren

sort ordent de elementen van dezelfde array, eventueel met een vergelijkingsfunctie, en retourneert dat arrayobject.

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

Syntax

array.sort(compareFn?)

array.sort(compareFn?) verzamelt aanwezige elementen en sorteert ze in hetzelfde object. De retourwaarde is precies array. Bij compareFn(a, b) plaatst een negatief resultaat a vóór b, een positief resultaat erna, en nul of NaN bewaart hun relatieve volgorde. Sinds ES2019 moet de sortering stabiel zijn. De callback ontvangt nooit undefined.

Zonder compareFn worden waarden behalve undefined naar strings omgezet en per UTF-16-code-eenheid vergeleken; daardoor wordt [80, 9, 100] [100, 80, 9]. undefined volgt de andere waarden; lege posities volgen daarna en blijven gaten.

De methode muteert de ontvanger; gebruik toSorted() of kopieer eerst als dat ongewenst is. Ze is generiek voor array-achtige objecten: ze leest length, schrijft gesorteerde eigenschappen en verwijdert ontbrekende eindindexen. Een niet-aanroepbare compareFn werpt TypeError; fouten uit conversie, callback, accessors, proxytraps, schrijven of verwijderen worden doorgegeven.

Voorbeelden

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

Resultaat

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

Bronnen