Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.Collator — porównywanie tekstu według reguł języka

Intl.Collator porównuje ciągi znaków zgodnie z regułami wybranego języka. Jego compare można przekazać bezpośrednio do sortowania; znaczenie ma znak wyniku, a nie konkretna wartość liczbowa.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);

Intl.Collator należy do standardu internacjonalizacji ECMA-402, a nie do interfejsów DOM. Tworzy obiekt porównujący tekst zgodnie z ustawieniami regionalnymi (locales) i opcjami (options). Jawne podanie języka ogranicza zależność od domyślnych ustawień środowiska.

Intl.Collator.prototype.compare jest akcesorem zwracającym funkcję związaną z instancją. Można przekazać collator.compare bezpośrednio do array.sort(...), bez bind. Wynik ujemny oznacza, że pierwszy tekst poprzedza drugi, dodatni — że następuje po nim, a 0 — równoważność według reguł porównania. Nie zakładaj wartości dokładnie -1 lub 1; 0 nie musi oznaczać identycznych ciągów.

usage: "sort" służy porządkowaniu, a usage: "search" — sprawdzaniu równoważności, nie sortowaniu. sensitivity określa uwzględniane różnice: "base", "accent", "case" lub "variant". numeric: true włącza porównywanie sekwencji cyfr jako liczb, jeśli środowisko je obsługuje.

Dane językowe i szczegóły kolejności zależą od implementacji. Sprawdź dostępność API i wymaganych języków w docelowej przeglądarce; obecność w Node 24 nie dowodzi wsparcia przeglądarki. Intl.Collator.supportedLocalesOf(...) pomaga sprawdzić języki, a collator.resolvedOptions() — faktycznie wybrane ustawienia.

Przykłady

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);

Wynik

a,b,c
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła