CKTIS / JavaScript
Intl.Collator — uspoređivanje teksta prema jezičnim pravilima
Intl.Collator uspoređuje nizove prema pravilima odabranog jezika. Funkcija compare može se izravno proslijediti sortiranju; važan je predznak rezultata, a ne određena brojčana vrijednost.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator dio je standarda za internacionalizaciju ECMA-402, a ne DOM sučelja. Stvara objekt koji uspoređuje tekst prema jezičnim postavkama (locales) i opcijama (options). Izričito navođenje jezika smanjuje ovisnost o zadanim postavkama okruženja.
Intl.Collator.prototype.compare pristupnik je koji vraća funkciju povezanu s instancom. collator.compare možete izravno proslijediti funkciji array.sort(...), bez upotrebe bind. Negativan rezultat znači da je prvi niz ispred drugoga, pozitivan da je iza njega, a 0 označava ekvivalentnost prema pravilima usporedbe. Nemojte pretpostaviti da je rezultat točno -1 ili 1; 0 ne mora značiti da su nizovi istovjetni.
usage: "sort" služi za sortiranje, dok usage: "search" služi za provjeru ekvivalentnosti, a ne za sortiranje. sensitivity određuje koje se razlike uzimaju u obzir: "base", "accent", "case" ili "variant". numeric: true omogućuje uspoređivanje nizova znamenki kao brojeva, ako okruženje to podržava.
Jezični podaci i pojedinosti redoslijeda ovise o implementaciji. Provjerite dostupnost API-ja i potrebnih jezika u ciljnom pregledniku; dostupnost u Node 24 ne dokazuje podršku preglednika. Intl.Collator.supportedLocalesOf(...) pomaže provjeriti jezike, a collator.resolvedOptions() prikazuje stvarno odabrane postavke.
Primjeri
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);Rezultat
a,b,c true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.