Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.sort: ordinamento stabile sul posto

sort ordina gli elementi dello stesso array, facoltativamente con una funzione di confronto, e restituisce tale oggetto.

Versione: ECMAScript 2026 draft; stable ordering required since ECMAScript 2019; example target: Node.js 24.22.2

Sintassi

array.sort(compareFn?)

array.sort(compareFn?) raccoglie gli elementi presenti e li ordina nello stesso oggetto. Il valore restituito è proprio array. Con compareFn(a, b), un risultato negativo mette a prima di b, uno positivo dopo, mentre zero o NaN ne conserva l’ordine relativo. Da ES2019 l’ordinamento deve essere stabile. Il callback non riceve mai undefined.

Senza compareFn, i valori diversi da undefined sono convertiti in stringhe e confrontati per unità di codice UTF-16; quindi [80, 9, 100] diventa [100, 80, 9]. Gli undefined seguono gli altri valori; gli slot vuoti vengono dopo e restano lacune.

Il metodo muta il ricevente; usare toSorted() o copiare prima se non lo si desidera. È generico per oggetti array-like: legge length, scrive proprietà ordinate ed elimina gli indici finali mancanti. Un compareFn non invocabile genera TypeError; si propagano errori di conversione, callback, accessori, trap di proxy, scrittura o eliminazione.

Esempi

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

Risultato

true
test:1|deploy:2|docs:2
100,80,9
4 true false 1 3 undefined

Fonti