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

CKTIS / JavaScript

Array.prototype.toSorted : copie triée stable

toSorted trie de façon stable un nouveau tableau dense tout en laissant le receveur et son ordre initial inchangés.

Version : ECMAScript 2023; stable ordering required; example target: Node.js 24.22.2

Syntaxe

array.toSorted(compareFn?)

array.toSorted(compareFn?) renvoie un nouvel Array ordinaire dont les valeurs sont ordonnées de façon stable, sans modifier array. compareFn(a, b) suit sort() : négatif place a avant, positif après, et zéro ou NaN conserve l’ordre des valeurs égales. Le callback ne reçoit jamais undefined.

Sans callback, les valeurs autres que undefined sont comparées comme chaînes selon les unités UTF-16. undefined va à la fin. Les trous du receveur sont lus comme undefined, donc le résultat est dense. La méthode ignore Symbol.species et copie superficiellement les références.

Elle est générique pour les valeurs array-like. Un callback non appelable ou un receveur null ou undefined lève TypeError ; les erreurs de conversion, lecture, callback et proxy se propagent, et une longueur trop grande pour un Array ordinaire peut produire RangeError. L’API a été normalisée dans ECMAScript 2023.

Exemples

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]));

Résultat

test,deploy,docs
deploy,test,docs
100,80,9
3 true true true 1 3 undefined

Sources