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 lokalen Einträge enthält, die in den übergebenen locales unterstützt werden, ohne dass auf die Standardlocale der Laufzeitumgebung zurückgegriffen werden muss.
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. optionsOptional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher-
Der zu verwendende Locale-Matching-Algorithmus. Mögliche Werte sind
"lookup"und"best fit"; die Standardeinstellung ist"best fit". Informationen zu dieser Option finden Sie auf der Intl-Seite.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der angegebenen Locale-Tags darstellt, die in den Pluralisierungsregeln unterstützt werden, ohne dass auf die Standardlocale der Laufzeitumgebung zurückgegriffen werden muss.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, jedoch nicht Balinesisch in den Pluralregeln, gibt supportedLocalesOf die Indonesischen und Deutschen Sprach-Tags unverändert zurück, obwohl pinyin Kollation für die Pluralregeln weder relevant noch mit Indonesisch verwendet wird und ein spezialisiertes Deutsch für Indonesien vermutlich 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 balinesischen Sprecher auch Indonesisch verstehen, und deshalb auch das balinesische Sprach-Tag zurückgeben könnte.
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® 2025 Internationalization API Specification # sec-intl.pluralrules.supportedlocalesof |