Intl.PluralRules.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 2019.
Die statische Methode Intl.PluralRules.supportedLocalesOf()
gibt ein Array zurück, das die von den bereitgestellten Locales enthält, die in Pluralregeln unterstützt werden, ohne auf die Standard-Locales der Laufzeitumgebung zurückgreifen zu müssen.
Probieren Sie es aus
const locales = ["en-US", "ban", "ar-OM", "de-DE"];
const options = { localeMatcher: "lookup" };
console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// Expected output: Array ["en-US", "ar-OM", "de-DE"]
Syntax
Intl.PluralRules.supportedLocalesOf(locales)
Intl.PluralRules.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-Matching-Algorithmus. 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, die eine Teilmenge der gegebenen Locale-Tags darstellen, die in Pluralregeln unterstützt werden, ohne auf die Standard-Locales der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in Pluralregeln, dann gibt supportedLocalesOf
die Indonesischen und Deutschen Sprach-Tags unverändert zurück, selbst wenn pinyin
-Kollation weder für Pluralregeln relevant ist 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 eine adäquate Ü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.PluralRules.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
Specification |
---|
ECMAScript® 2026 Internationalization API Specification # sec-intl.pluralrules.supportedlocalesof |