CKTIS / JavaScript
Intl.ListFormat — listen an Gebietsschemata anpassen
Intl.ListFormat verbindet Zeichenfolgen in Listen mit Trennzeichen und Verknüpfungen, die zur jeweiligen Spracheinstellung passen. format() gibt Text zurück, während formatToParts() die ursprünglichen Elemente von eingefügtem Verbindungstext trennt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat ist eine durch ECMA-402 definierte Internationalisierungs-API und keine DOM-API. Erstelle einen Formatter mit new Intl.ListFormat(locales, options). Das Argument locales wählt bevorzugte Gebietsschemata aus; wenn es weggelassen wird, gilt das Standardgebietsschema der Umgebung.
Die Option type akzeptiert "conjunction" (Verknüpfung im Stil von „und“, Standard), "disjunction" (Alternativen im Stil von „oder“) oder "unit" (eine Liste von Einheiten). Die Option style akzeptiert "long" (Standard), "short" oder "narrow". Der Formatter übersetzt weder die Elemente noch formatiert er die Zahlen oder Einheiten selbst.
format(list) akzeptiert ein iterierbares Objekt, das ausschließlich Zeichenfolgen enthält; ein Element eines anderen Typs löst einen TypeError aus. Eine leere Liste ergibt "". formatToParts(list) gibt Objekte mit den Feldern type und value zurück: "element" kennzeichnet ein Eingabeelement und "literal" eingefügten Verbindungstext. So kannst du Elemente hervorheben, ohne die Interpunktion zu analysieren.
Der genaue Verbindungstext hängt von den Gebietsschemadaten der Implementierung ab; gehe nicht davon aus, dass er in allen Umgebungen gleich ist. Prüfe, ob Intl.ListFormat in der Zielumgebung verfügbar ist – seine Verfügbarkeit in Node belegt nicht die Browserunterstützung. Das Beispiel prüft den Erhalt der Elemente und den Wiederaufbau des Ergebnisses, nicht ein bestimmtes Trennzeichen.
Beispiele
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));Ergebnis
["Ada","Lin","Sam"] true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.