CKTIS / JavaScript
Intl.ListFormat — formatowanie list według ustawień regionalnych
Intl.ListFormat łączy tekstowe elementy listy przy użyciu separatorów i spójników właściwych dla ustawień regionalnych. format() zwraca tekst, a formatToParts() oddziela elementy od dodanych łączników.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat to API internacjonalizacji zdefiniowane w ECMA-402, a nie API DOM. Utwórz formatter przez new Intl.ListFormat(locales, options). Parametr locales wybiera preferowane ustawienia regionalne; jego pominięcie używa domyślnych ustawień środowiska.
Opcja type przyjmuje "conjunction" (łączenie typu „i”, domyślnie), "disjunction" (alternatywa typu „lub”) lub "unit" (lista jednostek). Opcja style przyjmuje "long" (domyślnie), "short" lub "narrow". Formatter nie tłumaczy elementów ani nie formatuje samych liczb czy jednostek.
format(list) przyjmuje obiekt iterowalny zawierający wyłącznie ciągi znaków; inny typ elementu powoduje TypeError. Pusta lista daje "". formatToParts(list) zwraca obiekty z polami type i value: "element" oznacza element wejściowy, a "literal" dodany łącznik. Dzięki temu można wyróżnić elementy bez analizowania interpunkcji.
Dokładne łączniki zależą od danych regionalnych implementacji; nie zakładaj identycznego tekstu we wszystkich środowiskach. Sprawdź dostępność Intl.ListFormat w docelowym środowisku — obecność w Node nie dowodzi obsługi w przeglądarce. Przykład sprawdza zachowanie elementów i odtworzenie wyniku, nie konkretny separator.
Przykłady
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));Wynik
["Ada","Lin","Sam"] true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.