Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.PluralRules — wybór kategorii liczby

Intl.PluralRules dobiera kategorię gramatyczną liczby według ustawień językowych. Metoda select zwraca nazwę kategorii, a nie odmieniony wyraz ani gotowy komunikat.

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 rules = new Intl.PluralRules(locales, options);
rules.select(value);

Intl.PluralRules należy do standardu internacjonalizacji ECMA-402, a nie do DOM. Metoda instancji PluralRules.select, formalnie Intl.PluralRules.prototype.select(value), zwraca kategorię: zero, one, two, few, many lub other. Dostępny podzbiór zależy od języka; nazwy nie oznaczają prostych testów równości.

Opcja type: "cardinal" jest domyślna i dotyczy liczebności. type: "ordinal" dotyczy pozycji w kolejności. API nie tłumaczy ani nie odmienia słów: aplikacja przypisuje tekst do kategorii i powinna zapewnić wariant other. Opcje cyfr i zaokrąglania mogą zmienić wynik wyboru.

Przykład jawnie wybiera en i reguły liczebności, aby nie zależeć od domyślnego języka środowiska. Oczekiwane wyjście zakłada dostępność angielskich danych językowych. Specyfikacja nie jest tabelą zgodności przeglądarek: sprawdź docelowe środowiska i dostępność języka przez Intl.PluralRules.supportedLocalesOf(["en"]). Obecność API w Node 24 nie dowodzi obsługi w przeglądarkach.

Przykłady

const rules = new Intl.PluralRules("en", { type: "cardinal" });
const forms = { one: "file", other: "files" };

for (const count of [0, 1, 2]) {
  const category = rules.select(count);
  console.log(`${count} ${forms[category] ?? forms.other}`);
}

Wynik

0 files
1 file
2 files

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

Źródła