Справочник JavaScript

Intl.ListFormat

Склеивает список в фразу с запятыми и союзом: «a, b и c».

Доступно с: ES2021

Синтаксис

new Intl.ListFormat(locales, options)

Параметры

Параметр	Тип	Описание
locales	string	Необязательный. Язык.
options	object	Необязательный. type: conjunction (и), disjunction (или), unit; style: long, short, narrow.

Возвращаемое значение

Intl.ListFormatОбъект с методом format(list).

Примеры

Список через «и» и через «или»:

const names = ['Anna', 'Oleg', 'Ivan'];
 
console.log(new Intl.ListFormat('en', { type: 'conjunction' }).format(names));
console.log(new Intl.ListFormat('en', { type: 'disjunction' }).format(names));

Результат:

Anna, Oleg, and Ivan
Anna, Oleg, or Ivan

Другие языки:

const names = ['Anna', 'Oleg', 'Ivan'];
 
console.log(new Intl.ListFormat('de').format(names));
console.log(new Intl.ListFormat('ru').format(names));

Результат:

Anna, Oleg und Ivan
Anna, Oleg и Ivan

Примечания

В отличие от join(), форматтер ставит союз перед последним элементом и знает правила языка: например, запятую перед and в американском английском.

См. также

Array.prototype.join — Объединяет элементы массива в строку.
Intl.PluralRules — Выбирает форму слова для числа: 1 file, 2 files.

В учебнике

Форматирование: Intl — Форматирование чисел, денег, дат и окончаний слов в JavaScript с учётом языка: toLocaleString, Intl.NumberFormat, Intl.DateTimeFormat и Intl.PluralRules.

Спасибо, что читаете!