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.