WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.sort: stabile Sortierung an Ort und Stelle

sort ordnet die Elemente desselben Arrays optional mit einer Vergleichsfunktion und gibt dieses Arrayobjekt zurück.

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

Syntax

array.sort(compareFn?)

array.sort(compareFn?) sammelt vorhandene Elemente und sortiert sie im selben Objekt. Der Rückgabewert ist genau array. Bei compareFn(a, b) stellt ein negatives Ergebnis a vor b, ein positives dahinter; null oder NaN erhält die relative Reihenfolge. Seit ES2019 muss die Sortierung stabil sein. undefined wird dem Callback nie übergeben.

Ohne compareFn werden Werte außer undefined in Strings umgewandelt und nach UTF-16-Codeeinheiten verglichen; daher wird [80, 9, 100] zu [100, 80, 9]. undefined folgt den übrigen Werten, leere Plätze folgen danach und bleiben Lücken.

Die Methode mutiert den Empfänger; für eine Kopie eignet sich toSorted() oder vorheriges Kopieren. Sie ist für array-ähnliche Objekte generisch: Sie liest length, schreibt sortierte Eigenschaften und löscht fehlende Endindizes. Ein nicht aufrufbares compareFn löst TypeError aus; Fehler aus Konvertierung, Callback, Zugriffsmethoden, Proxy-Traps, Schreiben oder Löschen werden weitergegeben.

Beispiele

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

Ergebnis

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

Quellen