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 bei der Kollation ohne Rückgriff auf die Standardeinstellungen der Laufzeitumgebung unterstützt werden.
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 Arguments
locales
, siehe die Parameterbeschreibung auf der Hauptseite vonIntl
. options
Optional-
Ein Objekt, das die folgende Eigenschaft enthalten kann:
localeMatcher
-
Der zu verwendende Locale-Matching-Algorithmus. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Weitere Informationen zu dieser Option finden Sie auf der Seite Intl.
Rückgabewert
Ein Array von Strings, die eine Untermenge der angegebenen Locale-Tags darstellen, die bei der Kollation unterstützt werden, ohne auf die Standardeinstellungen der Laufzeitumgebung zurückzugreifen.
Beispiele
Nutzung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch bei der Kollation, so gibt supportedLocalesOf
die Sprach-Tags für Indonesisch und Deutsch unverändert zurück, auch wenn pinyin
-Kollation mit Indonesisch nicht verwendet wird und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie hier die Angabe des Algorithmus "lookup"
— 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 auch das Sprach-Tag für Balinesisch 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 |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
supportedLocalesOf |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- Has more compatibility info.