CKTIS / JavaScript
Array.prototype.toSorted: stabil sortierte Kopie
toSorted sortiert ein neues dichtes Array stabil und lässt Empfänger sowie ursprüngliche Reihenfolge unverändert.
Version: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2
Syntax
array.toSorted(compareFn?)array.toSorted(compareFn?) gibt ein neues gewöhnliches Array mit stabil geordneten Werten zurück, ohne array zu mutieren. compareFn(a, b) verhält sich wie bei sort(): negativ stellt a früher, positiv später, null oder NaN erhält die Reihenfolge gleicher Werte. Der Callback erhält nie undefined.
Ohne Callback werden Werte außer undefined als Strings nach UTF-16-Codeeinheiten verglichen. undefined kommt ans Ende. Lücken des Empfängers werden als undefined gelesen, daher ist das Ergebnis dicht. Die Methode ignoriert Symbol.species und kopiert Referenzen flach.
Sie ist für array-ähnliche Werte generisch. Ein nicht aufrufbarer Callback oder Empfänger null beziehungsweise undefined löst TypeError aus; Konvertierungs-, Lese-, Callback- und Proxyfehler werden weitergegeben, eine für gewöhnliche Arrays zu große Länge kann RangeError erzeugen. Das API stammt aus ECMAScript 2023.
Beispiele
const tasks = [
{ label: "deploy", priority: 2 },
{ label: "test", priority: 1 },
{ label: "docs", priority: 2 },
];
const ordered = tasks.toSorted((a, b) => a.priority - b.priority);
console.log(ordered.map(item => item.label).join(","));
console.log(tasks.map(item => item.label).join(","));
console.log([80, 9, 100].toSorted().join(","));
const dense = [3, , 1].toSorted((a, b) => a - b);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, dense[0], dense[1], String(dense[2]));Ergebnis
test,deploy,docs deploy,test,docs 100,80,9 3 true true true 1 3 undefined