CKTIS / JavaScript
Intl.Collator — confrontare il testo secondo le regole linguistiche
Intl.Collator confronta le stringhe secondo le regole di una lingua selezionata. La sua funzione compare può essere passata direttamente all’ordinamento; conta il segno del risultato, non un valore numerico specifico.
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
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator fa parte dello standard di internazionalizzazione ECMA-402, non delle interfacce DOM. Crea un oggetto che confronta il testo in base alle impostazioni locali (locales) e alle opzioni (options). Specificare esplicitamente una lingua riduce la dipendenza dalle impostazioni predefinite dell’ambiente.
Intl.Collator.prototype.compare è un accessor che restituisce una funzione associata all’istanza. Puoi passare collator.compare direttamente a array.sort(...), senza usare bind. Un risultato negativo significa che la prima stringa precede la seconda; un risultato positivo significa che la segue, mentre 0 indica equivalenza secondo le regole di confronto. Non presumere che il risultato sia esattamente -1 o 1; 0 non implica necessariamente che le stringhe siano identiche.
usage: "sort" serve per ordinare, mentre usage: "search" serve per verificare l’equivalenza, non per ordinare. sensitivity determina quali differenze considerare: "base", "accent", "case" o "variant". numeric: true consente di confrontare sequenze di cifre come numeri, se l’ambiente lo supporta.
I dati delle lingue e i dettagli dell’ordinamento dipendono dall’implementazione. Verifica la disponibilità dell’API e delle impostazioni locali necessarie nel browser di destinazione; la disponibilità in Node 24 non dimostra il supporto nei browser. Intl.Collator.supportedLocalesOf(...) aiuta a controllare le impostazioni locali, mentre collator.resolvedOptions() mostra quelle effettivamente selezionate.
Esempi
const collator = new Intl.Collator("en", { usage: "sort" });
const words = ["c", "a", "b"];
console.log(words.sort(collator.compare).join(","));
console.log(collator.compare("a", "b") < 0);
console.log(collator.compare("a", "a") === 0);Risultato
a,b,c true true
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.