CKTIS / JavaScript
Intl.Collator — porovnávání textu podle jazykových pravidel
Intl.Collator porovnává řetězce podle pravidel vybraného jazyka. Funkci compare lze předat přímo k řazení; důležité je znaménko výsledku, nikoli konkrétní číselná hodnota.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator patří do mezinárodního standardu ECMA-402, nikoli mezi rozhraní DOM. Vytváří objekt, který porovnává text podle nastavení prostředí (locales) a voleb (options). Výslovné zadání jazyka omezuje závislost na výchozím nastavení prostředí.
Intl.Collator.prototype.compare je přístupová vlastnost, která vrací funkci svázanou s instancí. collator.compare lze předat přímo do array.sort(...) bez použití bind. Záporný výsledek znamená, že první řetězec předchází druhému, kladný, že následuje po něm, a 0 znamená rovnocennost podle pravidel porovnávání. Nepředpokládejte, že výsledkem bude přesně -1 nebo 1; 0 nemusí znamenat totožné řetězce.
usage: "sort" slouží k řazení, zatímco usage: "search" slouží k ověření rovnocennosti, nikoli k řazení. sensitivity určuje, které rozdíly se zohlední: "base", "accent", "case" nebo "variant". numeric: true umožňuje porovnávat posloupnosti číslic jako čísla, pokud to prostředí podporuje.
Jazyková data a podrobnosti pořadí závisejí na implementaci. V cílovém prohlížeči ověřte dostupnost API a požadovaných jazyků; dostupnost v Node 24 nedokazuje podporu v prohlížeči. Intl.Collator.supportedLocalesOf(...) pomáhá ověřit jazyky a collator.resolvedOptions() ukazuje skutečně zvolená nastavení.
Příklady
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);Výsledek
a,b,c true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.