Удалите ручную формулу по последней цифре и сначала выведите три значения: locale, исходное число и результат plural selector. Для русского 21 относится к one, а 11 — к many; проверка только n % 10 путает их. Дроби добавляют ещё одну ветку, которую целочисленный helper часто вообще не видел.
Plural category — не перевод слов one/few/many. Это стабильные метки правил CLDR, набор которых зависит от языка и типа сообщения. Переводчик заполняет фразу для категорий, которые реально возможны в locale; other обязателен как общий fallback.
Граничные числа находят ошибку быстрее длинного списка
| Число для ru | Ожидаемая category | Фраза с «товар» |
|---|---|---|
| 1 | one | 1 товар |
| 2 | few | 2 товара |
| 5 | many | 5 товаров |
| 11 | many | 11 товаров |
| 21 | one | 21 товар |
| 1.5 | other | 1,5 товара |
Таблица относится к cardinal plurals для русской locale и конкретной фразе. CLDR подчёркивает: имена категорий мнемонические, а не универсальные грамматические определения. У другого языка 0 может попасть в one, other или отдельную zero; копировать русскую матрицу нельзя.
Intl.PluralRules возвращает категорию, а не текст
const forms = {
one: "# товар",
few: "# товара",
many: "# товаров",
other: "# товара",
};
const rules = new Intl.PluralRules("ru", { type: "cardinal" });
const category = rules.select(count);
const message = forms[category].replace("#", String(count));Пример показывает выбор категории; production-код обычно использует MessageFormat/i18n-библиотеку, чтобы корректно форматировать число и подставлять #. Не превращайте число в локализованную строку до select: selector должен получить Number, а запятая и grouping относятся к отображению.
Cardinal и ordinal отвечают на разные вопросы
Cardinal выбирает форму количества: «2 товара». Ordinal — форму порядка: «2-й». ECMA‑402 принимает option type со значением cardinal или ordinal. Если общий helper случайно создаёт ordinal rules для корзины, категории будут другими даже при той же locale.
- Хранить locale полного запроса, а не угадывать её по стране или валюте.
- Нормализовать BCP 47 tag средствами i18n stack и логировать resolved locale.
- Не смешивать formatted string с числом, участвующим в выборе category.
- Оставлять other в каждом plural message, даже если кажется недостижимым.
- Использовать явные =0/=1 только для особого смысла, а не вместо языковых правил.
ICU message держит формы рядом
Синтаксис ICU позволяет записать одно сообщение с plural cases: one, few, many, other и при необходимости точными =0. FormatJS рекомендует оставлять plural как можно выше в сообщении, чтобы переводчик видел целую естественную фразу, а не собирал её из разрозненных существительных и окончаний.
Фраза «нет товаров» может быть продуктовым вариантом для точного нуля и оформляться =0. Это не означает, что locale обязана иметь CLDR-category zero. Точный selector проверяется раньше category и решает отдельную задачу текста.
Тест строится из категорий locale
- Получить resolvedOptions().pluralCategories для поддерживаемой locale.
- Выбрать минимальные пары CLDR для каждой категории и добавить 0, teens, 21/101 и дроби.
- Проверить исходное число, выбранную category и итоговую фразу snapshot/таблицей.
- Повторить cardinal и используемые ordinal messages отдельно.
- Запустить тест для fallback locale и отсутствующего translation key.
Не фиксируйте в тесте только 1, 2 и 5: такой набор не ловит 11/21 и дроби. При обновлении CLDR или i18n runtime изменения категорий рассматриваются как изменение локализационных данных — snapshots пересматриваются вместе с переводчиком, а не автоматически принимаются.
Диагностика помещается в одну строку
Для ошибки достаточно записать message key, requested/resolved locale, type, raw numeric value, selected category и версию i18n runtime без пользовательского текста. С этими данными видно, потерялась ли locale, число стало строкой, выбрана ordinal rule или отсутствует форма перевода.
Для ревью приложите перевод одного ключа во всех формах и таблицу граничных чисел, не весь словарь приложения. Так можно проверить грамматику с носителем языка и технический selector независимо друг от друга.