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 Intl.PluralRules.supportedLocalesOf() statische Methode gibt ein Array zurück, das diejenigen der 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-Sprachtag 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 Algorithmen zum Abgleichen von Locales. 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 Pluralregeln unterstützt werden, ohne dass auf die Standard-Locales der Laufzeitumgebung zurückgegriffen werden muss.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in Pluralregeln, dann gibt supportedLocalesOf die indonesischen und deutschen Sprachtags unverändert zurück, selbst wenn die pinyin-Sortierung weder für Pluralregeln relevant noch mit Indonesisch verwendet wird, und ein spezialisierter deutscher Tag 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 eine angemessene Entsprechung für Balinesisch ist, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher das Balinesische Sprachtag 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 |