CKTIS / JavaScript
Array-elementen sorteren en vergelijken
Sorteren ordent elementen volgens een vergelijkingsregel. Leer over de standaard tekstuele volgorde, numerieke comparators, stabiliteit en het verschil tussen sort(), dat de array wijzigt, en toSorted(), dat een kopie maakt.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
array.sort(compareFn)
array.toSorted(compareFn)
compareFn(a, b) // Number: < 0, 0, > 0Sorteren ordent elementen volgens een vergelijkingsregel. array.sort(compareFn) wijzigt de array en geeft diezelfde array terug. Zonder compareFn vergelijkt het de tekenreeksrepresentaties van elementen lexicografisch op basis van UTF-16-code-eenheden, niet numeriek: [10, 2, 1].sort() levert [1, 10, 2] op.
Een comparator ontvangt a en b en geeft een Number terug: een negatieve waarde als a eerder moet komen, een positieve als het later moet komen, of 0 als de elementen dezelfde prioriteit hebben. Voor eindige getallen sorteert (a, b) => a - b oplopend en (a, b) => b - a aflopend. Gebruik niet (a, b) => a > b: een booleaans resultaat beschrijft niet alle drie de gevallen correct. Een comparator hoort deterministisch te zijn, de vergeleken gegevens niet te wijzigen en de tekenconsistentie bij omgewisselde argumenten en de transitiviteit te behouden. Een resultaat NaN wordt behandeld als 0.
Sorteren is stabiel: elementen die als gelijk worden vergeleken, behouden hun oorspronkelijke volgorde. Je kunt objecten dus op een veld sorteren zonder de volgorde van gelijke waarden te veranderen. De specificatie schrijft geen specifiek algoritme voor en geeft geen garanties over tijds- of ruimtecomplexiteit. In gewone arrays komt undefined na de andere waarden, zonder dat de comparator ervoor wordt aangeroepen; sort() plaatst lege posities na undefined.
array.toSorted(compareFn) is sinds ECMAScript 2023 gestandaardiseerd en geeft een nieuwe, ondiepe kopie in gesorteerde volgorde terug. De methode zoekt bij elke index op de gebruikelijke manier naar een eigenschap. Ook als de array op die index geen eigen eigenschap heeft, kan de methode een overgeërfde waarde lezen. Het lezen levert alleen undefined op als er geen eigenschap wordt gevonden of als de gevonden eigenschap zelf undefined oplevert. Controleer vóór gebruik typeof Array.prototype.toSorted === "function" in de doelomgeving; beschikbaarheid in Node.js bewijst niet dat browsers het ondersteunen. Het voorbeeld gebruikt [...numbers].sort(...) om de oorspronkelijke dichte array te behouden zonder toSorted() nodig te hebben.
Voorbeelden
const numbers = [10, 2, 1];
const lexical = [...numbers].sort();
const numeric = [...numbers].sort((a, b) => a - b);
console.log(JSON.stringify(lexical));
console.log(JSON.stringify(numeric));
console.log(JSON.stringify(numbers));Resultaat
[1,10,2] [1,2,10] [10,2,1]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.