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 die der bereitgestellten Locale enthält, die in der Zahlformatierung unterstützt werden, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.

Probieren Sie es aus

Syntax

js
Intl.NumberFormat.supportedLocalesOf(locales)
Intl.NumberFormat.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 der Intl-Hauptseite.

options Optional

Ein Objekt, das folgende Eigenschaft haben kann:

localeMatcher

Der zu verwendende Locale-Abgleichsalgorithmus. 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 gegebenen Locale-Tags darstellt, die in der Zahlformatierung unterstützt werden, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Zahlformatierung, gibt supportedLocalesOf die indonesischen und deutschen Sprachtags unverändert zurück, obwohl pinyin-Kollation weder für die Zahlformatierung relevant noch mit Indonesisch verwendet wird und ein spezielles 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 für Balinesisch ausreichend ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher das balinesische Sprach-Tag ebenfalls zurückgeben.

js
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 Internationalization API Specification
# sec-intl.numberformat.supportedlocalesof

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch