Гайды

Как склонять слова после чисел в 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 ? и > 1 ? рядом с текстом. Обычно таких мест больше, чем кажется: корзина, уведомления, «осталось N дней».

  2. Запиши формы слова. Для каждого слова нужны три формы плюс форма для дробей. Удобно хранить их объектом:

    const FILE = { one: "файл", few: "файла", many: "файлов", other: "файла" }
    

    Ключи one, few, many, other — не случайные. Это официальные названия категорий, их и вернёт браузер.

  3. Подключи 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". Никаких остатков от деления в твоём коде.

  4. Создай правила один раз. Обрати внимание: new Intl.PluralRules("ru") стоит снаружи функции. Если создавать его внутри на каждый вызов, длинный список заметно замедлится.

  5. Проверь на неудобных числах. Не на 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 файла

    Это готовый набор для автотеста. Если пишешь тесты с помощью ИИ, отдай ему этот список целиком.

  6. Сделай то же для английского. Если приложение двуязычное, правила английского другие — всего две категории:

    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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →