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 Lokalisierungen (Locales) enthält, die in Pluralregeln unterstützt werden, ohne dass auf die Standardlokale 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

js
Intl.PluralRules.supportedLocalesOf(locales)
Intl.PluralRules.supportedLocalesOf(locales, options)

Parameter

locales

Ein String mit einem BCP 47-Sprachcode oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des locales-Arguments sehen Sie die Parameterbeschreibung auf der Intl-Hauptseite.

options Optional

Ein Objekt, das die folgende Eigenschaft enthalten kann:

localeMatcher

Der Algorithmus, der zur Lokalisierung verwendet werden soll. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Weitere Informationen zu dieser Option finden Sie auf der Intl Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der gegebenen Sprachkennzeichen repräsentiert, die in Pluralregeln unterstützt werden, ohne auf die Standardlokale der Laufzeitumgebung zurückgreifen zu müssen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in Pluralregeln, gibt supportedLocalesOf die indonesischen und deutschen Sprachkennzeichen unverändert zurück. Dies geschieht, obwohl die pinyin-Sortierung weder für Pluralregeln relevant noch für Indonesisch verwendet wird und eine spezialisierte deutsche Lokalisierung 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 Übereinstimmung für Balinesisch ist, da die meisten Balinesischsprecher auch Indonesisch verstehen, und daher das balinesische Sprachkennzeichen ebenfalls zurückgeben.

js
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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
supportedLocalesOf

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch