Intl.Locale.prototype.getCollations()
Baseline 2026
Neu verfügbar
Seit Juli 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die Methode getCollations() von Intl.Locale-Instanzen gibt eine Liste mit einem oder mehreren Sortierungstypen für diese Locale zurück.
Hinweis:
In einigen Versionen mancher Browser wurde diese Methode als Accessor-Property namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie jetzt als Methode implementiert. So wird vermieden, dass locale.collations === locale.collations den Wert false zurückgibt. Einzelheiten finden Sie in der Tabelle zur Browser-Kompatibilität.
Syntax
getCollations()
Parameter
Keine.
Rückgabewert
Ein Array von Strings, das alle für die Locale gebräuchlichen Sortierungstypen in alphabetischer Reihenfolge enthält. Die Werte standard und search sind stets ausgeschlossen. Wenn für die Locale bereits eine collation festgelegt ist, enthält das zurückgegebene Array nur diesen einen Wert.
Eine Liste der unterstützten Sortierungstypen finden Sie unter Intl.supportedValuesOf().
Beispiele
Unterstützte Sortierungstypen abrufen
Wenn für das Locale-Objekt noch keine collation festgelegt ist, listet getCollations() alle gebräuchlichen Sortierungstypen für die angegebene Locale auf. Beispiele für das explizite Festlegen einer collation finden Sie unter Beispiele für collation.
const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["emoji", "eor", "pinyin", "stroke", "zhuyin"]
Spezifikationen
| Spezifikation |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getCollations |