Intl.Locale.prototype.getCollations()

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

getCollations() 方法是 Intl.Locale 例項的方法,它返回此地區(locale)的一個或多個 排序型別(collation types)的列表。

注意: 在某些瀏覽器版本中,此方法曾被實現為一個名為 collations 的訪問器屬性。然而,由於它每次訪問都會返回一個新的陣列,因此現在已將其實現為一種方法,以防止 locale.collations === locale.collations 返回 false 的情況。有關詳細資訊,請參閱 瀏覽器相容性表格

語法

js
getCollations()

引數

無。

返回值

一個包含字串的陣列,表示此 Locale 常用的所有排序型別,按字母順序排序,並且始終排除 standardsearch 值。如果 Locale 已經有一個 collation,則返回的陣列將包含該單個值。

支援的排序型別列表,請參閱 Intl.supportedValuesOf()

示例

獲取支援的排序型別

如果 Locale 物件還沒有 collationgetCollations() 會列出給定 Locale 的所有常用排序型別。有關顯式設定 collation 的示例,請參閱 collation 示例

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

規範

規範
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getCollations

瀏覽器相容性

另見