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 Intl.ListFormat-Instanzen gibt eine Zeichenkette zurück, die eine sprachspezifische Darstellung der Liste enthält.

Syntax

format(list)

Parameter

list: Ein iterierbares Objekt, wie beispielsweise ein Array, das Zeichenketten enthält. Wenn es ausgelassen wird, wird das leere Array formatiert, was etwas verwirrend sein kann, daher wird empfohlen, immer explizit eine Liste zu übergeben.

Rückgabewert

Eine sprachspezifisch formatierte Zeichenkette, die 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 Lokalisierung — Abweichungen in der Ausgabe sind beabsichtigt und gemäß der Spezifikation erlaubt. Es könnte auch nicht dem entsprechen, was Sie erwarten. Beispielsweise könnte die Zeichenkette geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von format() nicht mit fest kodierten Konstanten vergleichen.

Beispiele

Verwendung von format

Das folgende Beispiel zeigt, wie man einen Listen-Formatter mit der englischen Sprache erstellt.

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