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 dieses Gebietsschema zurück.
Hinweis:
In einigen Versionen bestimmter Browser war diese Methode als Accessor-Property namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, ist sie nun 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 Zeichenfolgen, das alle für das Locale häufig verwendeten Sortierungstypen in alphabetischer Reihenfolge enthält. Die Werte standard und search sind immer ausgeschlossen. Wenn für das Locale bereits ein Wert für collation festgelegt ist, enthält das zurückgegebene Array nur diesen Wert.
Eine Liste der unterstützten Sortierungstypen finden Sie unter Intl.supportedValuesOf().
Beispiele
>Unterstützte Sortierungstypen abrufen
Wenn für das Locale-Objekt noch kein Wert für collation festgelegt ist, listet getCollations() alle häufig verwendeten Sortierungstypen für das angegebene Locale auf. Beispiele für das explizite Festlegen von collation finden Sie in den Beispielen zu 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> |