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 bereitgestellten locales enthält, die bei der Zahlenformatierung ohne Rückgriff auf die Standard-locale der Laufzeitumgebung unterstützt werden.

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 der Intl Hauptseite.

options Optional

Ein Objekt, das die folgende Eigenschaft enthalten kann:

localeMatcher: Der zu verwendende Algorithmus zur Lokalisierungsanpassung. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Für Informationen zu dieser Option, siehe die Intl Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der angegebenen Locale-Tags repräsentiert, die bei der Zahlenformatierung unterstützt werden, ohne auf die Standard-locale der Laufzeitumgebung zurückzugreifen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch bei der Zahlenformatierung. In diesem Fall gibt supportedLocalesOf die Sprach-Tags für Indonesisch und Deutsch unverändert zurück, auch wenn die pinyin-Kollation weder für die Zahlenformatierung relevant ist noch mit Indonesisch verwendet wird, und ein spezialisierter deutscher Dialekt für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Spezifikation des Algorithmus "lookup" hier — ein "best fit"-Matcher könnte entscheiden, dass Indonesisch eine ausreichende Übereinstimmung für Balinesisch ist, da die meisten Balinesisch-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.NumberFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification # sec-intl.numberformat.supportedlocalesof

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Intl.NumberFormat