Как склонять слова после чисел в JavaScript — «1 файл, 2 файла, 5 файлов» без ошибок

Ты попросил ИИ вывести «Загружено N файлов». Он написал:
`${n} ${n === 1 ? "файл" : "файлов"}`
Проверяешь на 1 — «1 файл». На 5 — «5 файлов». Отлично, в продакшен. А потом пользователь загружает два файла и видит «2 файлов». Или двадцать один — «21 файлов».
Смотри, в чём подвох: это правило списано с английского. Там у слова две формы: file и files. В русском их три, а выбор зависит от последних цифр числа, причём у 11–14 свои исключения. Хорошая новость: считать это руками не нужно. В JavaScript уже встроен справочник правил для всех языков. Пройдём по шагам.
Как устроено русское правило
Сначала — чтобы понимать, что именно мы чиним. Русское слово после числа бывает в трёх формах:
- одна штука: 1, 21, 31, 101 — «файл»;
- несколько: 2–4, 22–24, 102 — «файла»;
- много: 0, 5–20, 25, 111 — «файлов».
Ловушка в подростках. 11, 12, 13, 14 заканчиваются на 1–4, но это «много»: «11 файлов», «12 файлов». И так же 111, 112.
Есть и четвёртый случай — дроби: «1,5 файла». Про него почти всегда забывают.
Шаг за шагом
-
Найди все места. Ищи в проекте
=== 1 ?и> 1 ?рядом с текстом. Обычно таких мест больше, чем кажется: корзина, уведомления, «осталось N дней». -
Запиши формы слова. Для каждого слова нужны три формы плюс форма для дробей. Удобно хранить их объектом:
const FILE = { one: "файл", few: "файла", many: "файлов", other: "файла" }Ключи
one,few,many,other— не случайные. Это официальные названия категорий, их и вернёт браузер. -
Подключи Intl.PluralRules. Это встроенный объект, который знает правила языков:
const ru = new Intl.PluralRules("ru") function plural(n, forms) { return `${n} ${forms[ru.select(n)]}` }ru.select(21)вернёт"one",ru.select(22)—"few",ru.select(11)—"many". Никаких остатков от деления в твоём коде. -
Создай правила один раз. Обрати внимание:
new Intl.PluralRules("ru")стоит снаружи функции. Если создавать его внутри на каждый вызов, длинный список заметно замедлится. -
Проверь на неудобных числах. Не на 1 и 5, а на тех, где обычно ломается. Вот что должно получиться:
plural(0, FILE)— 0 файловplural(1, FILE)— 1 файлplural(2, FILE)— 2 файлаplural(11, FILE)— 11 файловplural(21, FILE)— 21 файлplural(22, FILE)— 22 файлаplural(111, FILE)— 111 файловplural(1.5, FILE)— 1.5 файла
Это готовый набор для автотеста. Если пишешь тесты с помощью ИИ, отдай ему этот список целиком.
-
Сделай то же для английского. Если приложение двуязычное, правила английского другие — всего две категории:
const en = new Intl.PluralRules("en") en.select(1) // "one" en.select(21) // "other" — 21 filesБонус: у английского есть ещё порядковые числа.
new Intl.PluralRules("en", { type: "ordinal" }).select(22)вернёт"two"— значит, «22nd».
Что получится
Одна маленькая функция вместо десятка тернарных операторов. Она правильно склоняет любое число, включая 0, 11–14, сотни и дроби. Чтобы добавить новый язык, хватит передать другой код: "uk", "pl", "de".
Если в проекте уже есть i18next
Тогда руками ничего писать не надо. Библиотека сама зовёт Intl.PluralRules. Ты просто заводишь ключи с суффиксами: files_one, files_few, files_many, files_other. И вызываешь t("files", { count: n }).
Как попросить ИИ сделать это сразу правильно
сделай чтобы писало 1 файл 2 файла 5 файловВо всём проекте склонение слов после чисел сделано через n === 1 ? ... : .... Замени на одну функцию plural(n, forms) на базе Intl.PluralRules с локалью из настроек приложения. Формы храни объектом с ключами one, few, many, other. Объект PluralRules создай один раз на локаль. Добавь тест на числа 0, 1, 2, 5, 11, 12, 21, 22, 111 и 1.5 для русского и 1, 2, 21 для английского.Когда ИИ вернёт код, проверь его глазами: не осталось ли где-нибудь старого === 1.
А если нужно слово без числа?
Тоже работает: вызывай forms[ru.select(n)] и выводи только слово. Например, «Осталось: 3» и рядом «дня». Само число в строку вставлять не обязательно.
Это работает во всех браузерах?
Да, во всех современных. Intl.PluralRules есть в Chrome и Firefox с 2017–2018 годов, в Safari — с 13-й версии, в Node — из коробки.
Почему для 1.5 форма «файла», а не «файлов»?
Так устроен русский: дробное число согласуется как «несколько» — «полтора файла», «2,5 файла». Браузер возвращает для дробей категорию other, и в неё мы положили «файла».
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





