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ückgreifen zu müssen.
Syntax
Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.supportedLocalesOf(locales, options)
Parameter
locales
-
Ein String mit einem BCP 47-Sprachtag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des
locales
Arguments siehe die Parameterbeschreibung auf derIntl
Hauptseite. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der Locale-Abgleichsalgorithmus, der verwendet werden soll. Mögliche Werte sind
"lookup"
und"best fit"
; standardmäßig wird"best fit"
verwendet. Für Informationen zu dieser Option, siehe die Intl Seite.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags darstellt, 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 Laufzeit unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Listenformatierung, gibt supportedLocalesOf
die Indonesischen und Deutschen Sprachtags unverändert zurück, obwohl pinyin
-Kollation weder für die Listenformatierung relevant noch mit Indonesisch verwendet wird und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Spezifikation des "lookup"
-Algorithmus hier — ein "best fit"
-Matcher könnte entscheiden, dass Indonesisch ein ausreichender Ersatz für Balinesisch ist, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher auch das Balinesische Sprach-Tag zurückgeben.
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 |