Intl.Locale.prototype.getCollations()
Baseline
2026
Neu verfügbar
Seit July 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.
Want more browser support for this feature? Tell us why.
Die getCollations()-Methode von Intl.Locale-Instanzen gibt eine Liste von einem oder mehreren Kollationstypen für diese Locale zurück.
Hinweis:
In einigen Versionen bestimmter Browser wurde diese Methode als Zugriffsobjekteigenschaft namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, wird sie nun als Methode implementiert, um zu verhindern, dass locale.collations === locale.collations false zurückgibt. Überprüfen Sie die Browser-Kompatibilitätstabelle für Details.
Syntax
getCollations()
Parameter
Keine.
Rückgabewert
Ein Array von Zeichenfolgen, das alle für die Locale gebräuchlichen Kollationstypen in alphabetischer Reihenfolge darstellt, wobei die Werte standard und search immer ausgeschlossen sind. Wenn die Locale bereits eine collation hat, enthält das zurückgegebene Array diesen einzelnen Wert.
Für eine Liste unterstützter Kollationstypen siehe Intl.supportedValuesOf().
Beispiele
Ermitteln von unterstützten Kollationstypen
Wenn das Locale-Objekt noch keine collation hat, listet getCollations() alle gebräuchlichen Kollationstypen für die gegebene Locale auf. Für Beispiele zum expliziten Festlegen einer collation, siehe collation-Beispiele.
const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["pinyin", "stroke", "zhuyin", "emoji", "eor"]
Spezifikationen
| Spezifikation |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getCollations |