Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti