Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła