CKTIS / JavaScript
Array.prototype.sort : tri stable sur place
sort ordonne les éléments du même tableau, éventuellement avec une fonction de comparaison, et renvoie ce tableau.
Version : ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2
Syntaxe
array.sort(compareFn?)array.sort(compareFn?) collecte les éléments présents et les trie dans le même objet. La valeur renvoyée est exactement array. Avec compareFn(a, b), un résultat négatif place a avant b, un résultat positif après, tandis que zéro ou NaN conserve leur ordre relatif. Depuis ES2019, le tri doit être stable. Le callback ne reçoit jamais undefined.
Sans compareFn, les valeurs autres que undefined sont converties en chaînes et comparées par unités de code UTF-16 ; [80, 9, 100] devient donc [100, 80, 9]. Les valeurs undefined suivent les autres, puis viennent les emplacements vides, qui restent des trous.
La méthode modifie son récepteur ; utilisez toSorted() ou copiez d’abord pour l’éviter. Elle est générique pour les objets array-like : elle lit length, écrit les propriétés triées et supprime les indices finaux absents. Un compareFn non appelable lève TypeError ; les erreurs de conversion, du callback, des accesseurs, des traps de proxy, d’écriture ou de suppression se propagent.
Exemples
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]));Résultat
true test:1|deploy:2|docs:2 100,80,9 4 true false 1 3 undefined