Intl.DisplayNames.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 statische Methode Intl.DisplayNames.supportedLocalesOf()
gibt ein Array zurück, das die der angegebenen locales
enthält, die in Anzeige-Namen unterstützt werden, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.
Syntax
Intl.DisplayNames.supportedLocalesOf(locales)
Intl.DisplayNames.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 derIntl
Hauptseite. options
Optional-
Ein Objekt, das die folgende Eigenschaft enthalten kann:
localeMatcher
-
Der zu verwendende Locale-Matching-Algorithmus. Mögliche Werte sind
"lookup"
und"best fit"
; der Standard 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 darstellt, die in Anzeige-Namen unterstützt werden, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt in Anzeige-Namen Indonesisch und Deutsch, aber nicht Balinesisch, dann gibt supportedLocalesOf
die Indonesischen und Deutschen Sprach-Tags unverändert zurück, obwohl die pinyin
-Kollation weder für Anzeige-Namen 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 eine angemessene Übereinstimmung für Balinesisch ist, da die meisten Balinesischen Sprecher auch Indonesisch verstehen und daher das Balinesische Sprach-Tag ebenfalls zurückgeben.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.DisplayNames.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
Specification |
---|
ECMAScript® 2026 Internationalization API Specification # sec-Intl.DisplayNames.supportedLocalesOf |