Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Intl.ListFormat.supportedLocalesOf()

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 Intl.ListFormat.supportedLocalesOf() statische Methode gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die in der Listenformatierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückfallen zu müssen.

Syntax

js
Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.supportedLocalesOf(locales, options)

Parameter

locales

Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des locales Arguments siehe die Parameterbeschreibung auf der Intl Hauptseite.

options Optional

Ein Objekt, das die folgende Eigenschaft haben kann:

localeMatcher

Der zu verwendende Locale-Abgleichsalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Informationen zu dieser Option finden Sie auf der Intl Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags repräsentiert, die in der Listenformatierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Listenformatierung, so gibt supportedLocalesOf die indonesischen und deutschen Sprach-Tags unverändert zurück, obwohl pinyin Kollation weder relevant für die Listenformatierung noch bei Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Angabe des "lookup" Algorithmus hier — ein "best fit"-Matcher könnte entscheiden, dass Indonesisch ein angemessener Ersatz für Balinesisch ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher das balinesische Sprach-Tag ebenfalls zurückgeben.

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.ListFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.ListFormat.supportedLocalesOf

Browser-Kompatibilität

Siehe auch