Intl.ListFormat.prototype.format()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die format()-Methode von Instanzen von Intl.ListFormat gibt einen String mit einer sprachspezifischen Darstellung der Liste zurück.

Syntax

format()
format(list)

Parameter

list: Ein iterierbares Objekt, wie zum Beispiel ein Array.

Rückgabewert

Ein sprachspezifisch formatierter String, der die Elemente der Liste darstellt.

Hinweis: Meistens ist das von format() zurückgegebene Format konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, selbst innerhalb derselben Spracheinstellung — Variationen der Ausgabe sind beabsichtigt und durch die Spezifikation erlaubt. Es könnte auch nicht das sein, was Sie erwarten. Zum Beispiel kann der String geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von format() nicht mit festcodierten Konstanten vergleichen.

Beschreibung

Die format()-Methode gibt einen String zurück, der auf Grundlage der im Intl.ListFormat-Objekt bereitgestellten Parameter formatiert wurde. Die locales- und options-Parameter passen das Verhalten von format() an und ermöglichen es Anwendungen, die Sprachkonventionen zu spezifizieren, die zum Formatieren der Liste verwendet werden sollen.

Beispiele

Verwendung von format

Das folgende Beispiel zeigt, wie ein Listen-Formatter mit der englischen Sprache erstellt wird.

const list = ["Motorcycle", "Bus", "Car"];

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus and Car

console.log(
  new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
    list,
  ),
);
// Motorcycle, Bus or Car

console.log(
  new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(list),
);
// Motorcycle Bus Car

Spezifikationen

Specification
ECMAScript Internationalization API Specification # sec-Intl.ListFormat.prototype.format

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Intl.ListFormat