Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources