Intl.NumberFormat.supportedLocalesOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Die Intl.NumberFormat.supportedLocalesOf() statische Methode gibt ein Array zurück, das diejenigen der angegebenen Sprachvarianten enthält, die in der Zahlenformatierung unterstützt werden, ohne auf die Standard-Sprachvariante zur Laufzeit zurückgreifen zu müssen.
Probieren Sie es aus
const locales1 = ["ban", "id-u-co-pinyin", "de-ID"];
const options1 = { localeMatcher: "lookup" };
console.log(Intl.NumberFormat.supportedLocalesOf(locales1, options1));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
Syntax
Intl.NumberFormat.supportedLocalesOf(locales)
Intl.NumberFormat.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. optionsOptional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher-
Der zu verwendende Sprachvarianten-Abgleich-Algorithmus. Mögliche Werte sind
"lookup"und"best fit"; der Standardwert ist"best fit". Für Informationen über diese Option, siehe die Intl Seite.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der angegebenen Sprachvarianten-Tags repräsentiert, die in der Zahlenformatierung unterstützt werden, ohne auf die Standard-Sprachvariante zur Laufzeit zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Ausführungsumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Zahlenformatierung, dann gibt supportedLocalesOf die Indonesischen und Deutschen Sprach-Tags unverändert zurück, auch wenn pinyin-Kollation weder für die Zahlenformatierung 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 Balinesisch-Sprecher auch Indonesisch verstehen und dementsprechend auch das Balinesische Sprach-Tag zurückgeben.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl.numberformat.supportedlocalesof |