Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje