Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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.

js
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

Browser-Kompatibilität

Siehe auch