Intl.Locale.prototype.getCollations()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die getCollations()-Methode von Intl.Locale-Instanzen gibt eine Liste von einem oder mehreren Kollationstypen für diese Sprache zurück.

Hinweis: In einigen Versionen mancher Browser wurde diese Methode als Accessor-Eigenschaft namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, wird sie jetzt 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

js
getCollations()

Parameter

Keine.

Rückgabewert

Ein Array von Zeichenfolgen, das alle Kollationstypen enthält, die üblicherweise für die Locale verwendet werden, alphabetisch sortiert, wobei die Werte standard und search immer ausgeschlossen sind. Wenn die Locale bereits eine collation hat, dann enthält das zurückgegebene Array diesen einzelnen Wert.

Für eine Liste der unterstützten Kollationstypen siehe Intl.supportedValuesOf().

Beispiele

Erhalten von unterstützten Kollationstypen

Wenn das Locale-Objekt bereits keine collation hat, listet getCollations() alle üblicherweise verwendeten Kollationstypen für die gegebene Locale auf. Für Beispiele zur expliziten Festlegung einer collation siehe collation Beispiele.

js
const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["pinyin", "stroke", "zhuyin", "emoji", "eor"]

Spezifikationen

Specification
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getCollations

Browser-Kompatibilität

Siehe auch