CKTIS / JavaScript
Intl.ListFormat — форматиране на списъци според локала
Intl.ListFormat свързва текстовите елементи в списък с разделители и съюзи, подходящи за съответния локал. format() връща текст, а formatToParts() отделя първоначалните елементи от добавения свързващ текст.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat е API за интернационализация, дефиниран от ECMA-402, а не DOM API. Създайте форматиращ обект с new Intl.ListFormat(locales, options). Аргументът locales избира предпочитаните локали; ако го пропуснете, се използва локалът по подразбиране на средата.
Опцията type приема "conjunction" (свързване от типа на „и“, стойност по подразбиране), "disjunction" (алтернативи от типа на „или“) или "unit" (списък от мерни единици). Опцията style приема "long" (стойност по подразбиране), "short" или "narrow". Форматиращият обект нито превежда елементите, нито форматира самите числа или единици.
format(list) приема итерируем обект, съдържащ само низове; елемент от друг тип предизвиква TypeError. Празен списък дава "". formatToParts(list) връща обекти с полета type и value: "element" обозначава входен елемент, а "literal" — добавения свързващ текст. Така можете да откроите елементите, без да анализирате пунктуацията.
Точният свързващ текст зависи от локалните данни на реализацията; не приемайте, че е еднакъв във всички среди. Проверете дали Intl.ListFormat е наличен в целевата среда — наличието му в Node не доказва поддръжка в браузърите. Примерът проверява запазването на елементите и възстановяването на резултата, а не конкретен разделител.
Примери
const formatter = new Intl.ListFormat("en", {
type: "conjunction",
style: "long"
});
const items = ["Ada", "Lin", "Sam"];
const parts = formatter.formatToParts(items);
console.log(JSON.stringify(parts.filter(p => p.type === "element").map(p => p.value)));
console.log(parts.map(p => p.value).join("") === formatter.format(items));Резултат
["Ada","Lin","Sam"] true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.