База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници