JavaScript Intl.ListFormat: перечислить с «и»
Intl.ListFormat собирает массив в человекочитаемое перечисление по правилам языка: с запятыми, союзом «и» или «или». Он избавляет от ручного join(", "), который не учитывает локаль и не ставит союз перед последним элементом. Форматтер создаётся один раз и переиспользуется.
Перечислить элементы через «and»
const list = new Intl.ListFormat("en-US", {
style: "long",
type: "conjunction",
});
console.log(list.format(["Alice", "Bob", "Carol"])); // Alice, Bob, and Carol
const orList = new Intl.ListFormat("en-US", {
style: "short",
type: "disjunction",
});
console.log(orList.format(["red", "green"])); // red or greentype: "conjunction" соединяет через «и/and», type: "disjunction" — через «или/or». style задаёт длину: long, short или narrow. Для пустого массива возвращается пустая строка, для одного элемента — сам элемент, для двух — форма без лишней запятой.
Локализовать на русский
const ru = new Intl.ListFormat("ru-RU", {
style: "long",
type: "conjunction",
});
console.log(ru.format(["Анна", "Игорь", "Ольга"])); // Анна, Игорь и ОльгаРусская локаль не ставит запятую перед «и» так, как это делает английская Oxford comma. Для перечисления вариантов используйте type: "disjunction" и получите «Анна, Игорь или Ольга». Для единиц измерения есть type: "unit" в некоторых реализациях, но проверяйте поддержку.
ListFormat не экранирует HTML: если элементы приходят от пользователя, экранируйте их перед вставкой в DOM. Форматтер не заменяет грамматическое склонение отдельных слов — только расставляет разделители и союзы. Для сложных фраз с падежами нужен ICU-шаблон или библиотека.
Метод поддерживается в Chrome 72+, Firefox 78+, Safari 14.1+ и Node.js 13+. Локаль задавайте явно, чтобы серверный и клиентский рендер совпадали. Не создавайте форматтер для каждого элемента списка: вынесите его в модуль.
Документация: Intl.ListFormat, formatToParts.