CKTIS / JavaScript
Array.prototype.toSorted: stabiel gesorteerde kopie
toSorted sorteert een nieuwe dichte array stabiel en laat de ontvanger en diens oorspronkelijke volgorde ongewijzigd.
Versie: ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2
Syntax
array.toSorted(compareFn?)array.toSorted(compareFn?) retourneert een nieuwe gewone Array met stabiel geordende waarden, zonder array te muteren. compareFn(a, b) volgt sort(): negatief zet a eerder, positief later, en nul of NaN bewaart de volgorde van gelijke waarden. De callback krijgt nooit undefined.
Zonder callback worden waarden behalve undefined als strings per UTF-16-eenheid vergeleken. undefined komt achteraan. Gaten van de ontvanger worden als undefined gelezen, zodat het resultaat dicht is. De methode negeert Symbol.species en maakt een ondiepe kopie van referenties.
Ze is generiek voor array-achtige waarden. Een niet-aanroepbare callback of ontvanger null of undefined werpt TypeError; conversie-, lees-, callback- en proxyfouten worden doorgegeven, terwijl een te grote lengte voor een gewone Array RangeError kan geven. De API is gestandaardiseerd in ECMAScript 2023.
Voorbeelden
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]));Resultaat
test,deploy,docs deploy,test,docs 100,80,9 3 true true true 1 3 undefined