CKTIS / JavaScript
String.prototype.localeCompare — confronto del testo secondo le regole linguistiche
String.prototype.localeCompare confronta due stringhe secondo regole di ordinamento linguistiche. Il segno del risultato ne determina l’ordine; locales e options personalizzano il confronto negli ambienti che supportano ECMA-402.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
string.localeCompare(compareString, locales?, options?)String.prototype.localeCompare confronta la stringa ricevente con compareString. Un risultato negativo indica che la stringa viene prima dell’altra, uno positivo che viene dopo, mentre 0 indica equivalenza in quel confronto, non necessariamente testo identico. Controlla il segno del risultato, non i valori esatti -1 e 1.
Negli ambienti con ECMA-402, locales richiede una lingua preferita, ad esempio "en"; se viene omesso, si usano le impostazioni predefinite dell’ambiente. options personalizza il confronto: numeric: true ordina le sequenze di cifre in base al loro valore numerico. Le regole dipendono dai dati locali disponibili; senza ECMA-402 non si può fare affidamento sul supporto di questi argomenti.
Per ordinare, passa (a, b) => a.localeCompare(b, "en", options). Non passare il metodo da solo come funzione di confronto: richiede il corretto ricevente this. Nell’esempio, numeric: true mette item2 prima di item10; la riga prevista è item1, item2, item10.
Esempi
const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));Risultato
item1, item2, item10
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.