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 diejenigen der angegebenen Locales enthält, die in Anzeigebezeichnungen unterstützt werden, ohne auf die Standardsprache der Laufzeitumgebung zurückgreifen zu müssen.
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 der Hauptseite vonIntl
. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der zu verwendende Locale-Abgleichalgorithmus. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Weitere Informationen zu dieser Option finden Sie auf der Seite Intl.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der angegebenen Locale-Tags darstellt, die in Anzeigebezeichnungen unterstützt werden, ohne auf die Standardsprache der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in Anzeigebezeichnungen, gibt supportedLocalesOf
die Indonesischen und Deutschen Sprach-Tags unverändert zurück, auch wenn die pinyin
-Kollation weder für Anzeigebezeichnungen relevant ist noch mit 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 ausreichender Ersatz für Balinesisch ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher ebenfalls das Balinesische Sprach-Tag 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 |