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

浏览器兼容性

另见