Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti