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 Intl.Collator.supportedLocalesOf()
statische Methode gibt ein Array zurück, das die angegebenen Sprachumgebungen enthält, die bei Sortieroperationen unterstützt werden, ohne auf die standardmäßige Sprachumgebung der Laufzeitumgebung zurückzugreifen.
Probieren Sie es aus
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.Collator.supportedLocalesOf(locales, options));
// 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. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der zu verwendende Algorithmus zum Abgleichen der Sprachumgebung. 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 angegebenen Sprach-Tag enthält, die bei Sortieroperationen unterstützt werden, ohne auf die standardmäßige Sprachumgebung der Laufzeitumgebung zurückzugreifen.
Beispiele
>Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch bei Sortieroperationen, supportedLocalesOf
gibt die indonesischen und deutschen Sprach-Tags unverändert zurück, obwohl die pinyin
Sortierung bei Indonesisch nicht verwendet wird und ein spezialisiertes 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 geeignete Übereinstimmung für Balinesisch ist, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher auch 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® 2026 Internationalization API Specification> # sec-intl.collator.supportedlocalesof> |
Browser-Kompatibilität
Loading…