JavaScript Intl.ListFormat: перечислить с «и»

Категория: JavaScript · Язык: JavaScript · Обновлено:

Intl.ListFormat собирает массив в человекочитаемое перечисление по правилам языка: с запятыми, союзом «и» или «или». Он избавляет от ручного join(", "), который не учитывает локаль и не ставит союз перед последним элементом. Форматтер создаётся один раз и переиспользуется.

Перечислить элементы через «and»

JavaScript
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 green

type: "conjunction" соединяет через «и/and», type: "disjunction" — через «или/or». style задаёт длину: long, short или narrow. Для пустого массива возвращается пустая строка, для одного элемента — сам элемент, для двух — форма без лишней запятой.

Локализовать на русский

JavaScript
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.