Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.toSorted: copia ordinata stabile

toSorted ordina stabilmente un nuovo array denso lasciando invariati il ricevente e il suo ordine originale.

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

Sintassi

array.toSorted(compareFn?)

array.toSorted(compareFn?) restituisce un nuovo Array ordinario con valori ordinati stabilmente, senza mutare array. compareFn(a, b) segue sort(): un risultato negativo mette a prima, uno positivo dopo, e zero o NaN conserva l’ordine dei valori uguali. Il callback non riceve mai undefined.

Senza callback, i valori diversi da undefined sono confrontati come stringhe per unità UTF-16. undefined va in fondo. I vuoti del ricevente sono letti come undefined, quindi il risultato è denso. Il metodo ignora Symbol.species ed esegue una copia superficiale dei riferimenti.

È generico per valori array-like. Un callback non invocabile o un ricevente null o undefined genera TypeError; errori di conversione, lettura, callback e proxy si propagano, mentre una lunghezza eccessiva per un Array ordinario può produrre RangeError. L’API è stata standardizzata in ECMAScript 2023.

Esempi

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

Risultato

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

Fonti