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 Locale zurück.

Hinweis: In einigen Versionen bestimmter Browser wurde diese Methode als Zugriffsattribut namens collations implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, wird sie jetzt als Methode implementiert, um die Situation zu vermeiden, dass locale.collations === locale.collations false zurückgibt. Sehen Sie in der Tabelle zur Browser-Kompatibilität für weitere Details nach.

Syntax

js
getCollations()

Parameter

Keine.

Rückgabewert

Ein Array von Zeichenfolgen, das alle Kollationstypen darstellt, 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, enthält das zurückgegebene Array diesen einzelnen Wert.

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

Beispiele

Abrufen unterstützter Kollationstypen

Wenn das Locale-Objekt noch keine collation hat, listet getCollations() alle gängigen Kollationstypen für die angegebene Locale auf. Für Beispiele zur expliziten Einstellung 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

BCD tables only load in the browser

Siehe auch