Intl.Collator.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 statische Methode Intl.Collator.supportedLocalesOf() gibt ein Array zurück, das diejenigen der bereitgestellten Locales enthält, die in der Sortierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Probieren Sie es aus
const locales1 = ["ban", "id-u-co-pinyin", "de-ID"];
const options1 = { localeMatcher: "lookup" };
console.log(Intl.Collator.supportedLocalesOf(locales1, options1));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
Syntax
Intl.Collator.supportedLocalesOf(locales)
Intl.Collator.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 derIntl-Hauptseite. optionsOptional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher-
Der Algorithmus zur Locale-Abstimmung, der verwendet werden soll. Mögliche Werte sind
"lookup"und"best fit"; der Standardwert ist"best fit". Informationen zu dieser Option finden Sie auf der Intl-Seite.
Rückgabewert
Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags darstellt, die in der Sortierung unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt in der Sortierung Indonesisch und Deutsch, aber nicht Balinesisch. supportedLocalesOf gibt die Indonesischen und Deutschen Sprach-Tags unverändert zurück, obwohl die pinyin-Sortierung nicht mit Indonesisch verwendet wird und ein spezialisierter Deutscher 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 ausreichende Übereinstimmung für Balinesisch ist, da die meisten balinesischen Sprecher auch Indonesisch verstehen, und daher ebenfalls das balinesische Sprach-Tag zurückgeben.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.Collator.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
| Specification |
|---|
| ECMAScript® 2025 Internationalization API Specification # sec-intl.collator.supportedlocalesof |